Back to Blog

WhatsApp group chats for hotel guests: what the API allows

A hotel can now open a WhatsApp group with its guests from the messaging platform it already uses, but only if its number carries the verified blue badge, and only for groups of…

MN

Mushon Nachmani

vGuest

4 min read
WhatsApp group chats for hotel guests: what the API allows

A hotel can now open a WhatsApp group with its guests from the messaging platform it already uses, but only if its number carries the verified blue badge, and only for groups of up to eight people. Those two limits decide whether the feature is useful to you before any code is written.

What the Groups API actually does

Meta added groups to the WhatsApp Business Platform in 2026. A business number creates a group with a name and a description, and Meta returns an invite link. Guests tap the link and join. Once they are in, the hotel messages the group the same way it messages a single guest, and every reply lands as a normal inbound message tagged with the group id.

The limits are strict and worth knowing by heart. Meta's Groups documentation sets them at eight participants per group including the business number, and ten thousand groups per number. Group creation is asynchronous: the create call returns a request id, and the group id and invite link arrive a moment later through a webhook.

There is no call that adds a participant. The invite link is the only door. The business can remove someone, reset the link, change the subject, and delete the group. It cannot pull a guest in.

Which hotel use cases fit eight people

Eight is a family, not an event. The cases that work:

  • A family booking across two or three rooms. Parents, adult children, one thread for check-in times, the pool, and where dinner is.
  • A small group tour or a company offsite of a handful of people where one organiser wants everyone to hear the same answer.
  • A guest and their travel agent or event planner, with the hotel in the middle.

The cases that do not fit: a wedding party, a conference, a bus tour, a sports team. Any of those needs a broadcast list or a template campaign, not a group.

The invite-link rule also shapes the flow. The hotel sends one message per guest containing the link, and only guests who tap it are in. Send it to the person who made the booking; they forward it to their party. A link sent cold to people who did not book rarely gets tapped.

Why most hotel numbers get error 131215

The first call to create a group on an ordinary hotel number returns:

``` (#131215) This phone number is not eligible to access Groups APIs ```

We hit this on two customer numbers in September 2026, both on the Cloud API, both with business verification, both with every group webhook subscribed. We opened a support case with Meta. The answer was short: neither number had Official Business Account status, and groups are enabled automatically once a number does. There is no partner-level enablement, no waiting list, and no undocumented requirement beyond the badge.

That makes the blue badge the whole gate. Our guide to getting the WhatsApp blue badge for a hotel number walks through the request step by step, with screenshots from WhatsApp Manager.

Numbers that can never use groups

Two kinds of number are excluded outright, badge or not:

  • Numbers on the WhatsApp Business app. The app has its own groups; the API does not reach them.
  • Numbers in coexistence, where the same number runs in the app on a phone and on the Cloud API at the same time. Meta's documentation excludes these from groups explicitly.

Coexistence is popular with hotels because the front desk keeps its phone. It is also the single biggest reason a hotel cannot use groups. Moving a coexistence number to the Cloud API alone is a one-time change, and it has to happen before the badge request, because the badge review looks at the number as it is.

What it costs

Meta's pricing change of October 2026 bills every business-sent message on WhatsApp individually, and Meta's pricing pages do not carve out an exception for groups. Budget for a group message as you would for any business-initiated message, and check the current rate card before promising a customer that groups are cheaper than a broadcast.

What we built and what we left out

At vGuest, a hotel with an eligible number creates the group from the dashboard and gets the invite link there for the team to send. We deliberately did not put the AI assistant inside groups. It answers one guest at a time; a family thread with three people asking different things at once is exactly where an automated reply does damage, so group threads stay with the team.

If your hotel number is on the Cloud API and already carries the badge, groups work today. If it does not, the badge is the first step, and the guide above is where to start.

Common questions

Can a hotel create a WhatsApp group with its guests through the API?

Yes, since 2026 the WhatsApp Business Platform has a Groups API. The business number creates the group, gets an invite link, and guests join by tapping it. The group holds at most eight members including the hotel's own number, so it fits a family or a small travelling party, not a wedding or a conference.

Why does the Groups API return error 131215?

Error 131215 means the phone number is not eligible for groups. In every case we have seen, the cause is that the number does not carry the Official Business Account badge. Meta enables groups automatically once the badge is granted, and there is no other way to switch them on.

Does a number connected to the WhatsApp Business app qualify?

No. Numbers running in coexistence with the WhatsApp Business app, and numbers used only in the app, are excluded from groups regardless of verification. The number has to be a Cloud API number.

Can the hotel add guests to the group itself?

No. There is no endpoint that adds a participant. The only way in is the invite link, which the hotel sends to the guest in a normal message. The hotel can remove participants and reset the link.

All articles

190+ properties · 6 countries

See it answering your guests

Bring your own property. We will show you what the assistant does with your real questions, in your languages, on WhatsApp.