Ir para o conteúdo principal

WhatsApp Groups on the Business API: 8 Participants, Not 1,024

The Groups API caps a group at 8 participants, will not let you add anyone directly, and needs an Official Business Account. The documented rules.

Este artigo está disponível em inglês.

Saifullah Alam
Saifullah Alam

Publicado em

Illustration of a small WhatsApp group of eight participants beside a much larger crossed-out group

Almost everyone who discovers that the WhatsApp Business Platform has a Groups API arrives with the same plan: move the 900-member customer group off someone's personal phone and run it properly through the API. It is a reasonable plan and it will not work, for a reason that takes one number to explain.

A group created through the Groups API holds a maximum of 8 participants. The consumer WhatsApp app allows over a thousand. You also cannot add anyone to an API group — participants have to accept an invite link themselves — and the whole feature requires your business to be an Official Business Account, which is a higher bar than most people expect and is not a permission you can simply request. Everything below is from Meta's Groups API documentation and the group management reference.

The documented limits

LimitValue
Max group participants8
Max groups per business number10,000
Max Cloud API businesses per group1
Supported message typesText, media, text-based templates, media-based templates
Group subjectUp to 128 characters
Group descriptionUp to 2,048 characters
Group pictureJPEG only, 5 MB max, square, minimum 192×192

What this does and does not replace

The groups you already know, in the consumer and Business apps, are a different product with different rules. Lining them up side by side is the fastest way to work out whether the API is the thing you actually want:

What you want to doWhatsApp app groupsGroups API
Hold hundreds of members in one groupYesNo — 8 is the ceiling
Add a contact to the group yourselfYesNo — invite link only, they must accept
Create groups automatically, in volumeNoYes — up to 10,000 per number
Know programmatically who joined or leftNoYes — four webhook events report it
Send an approved template into the groupNoYes — text and media templates both work
Run it from the WhatsApp Business appYesNo — Cloud API numbers only
Reach many people with one messageYes, manuallyWrong tool — use broadcasts instead

That last row matters more than the rest. If the goal is one message reaching a large audience, groups are the wrong mechanism entirely and broadcasts are the right one — with their own rules, which we covered in WhatsApp broadcast limits, rules and cost.

Who can actually use it

Here is the part that is commonly misunderstood, including by people who have read about the feature. The gate is not a special groups permission. Meta's prerequisites ask for the standard whatsapp_business_messaging permission — the same one that already covers your normal messaging. What actually decides whether you can use groups is account status:

  • Official Business Account status is required. Meta's wording is that the Groups API is open to all businesses with an OBA. No OBA, no groups, with any provider.
  • The number must be on Cloud API, not the WhatsApp Business app.
  • Numbers onboarded to Multi-solution Conversations are excluded, as are WhatsApp Business app numbers.
  • A webhook server is required, subscribed to four group fields: group lifecycle, participants, settings and status updates.
  • Your app must be subscribed to the Messaging account of the business phone number.

If you are shopping providers on the strength of group support, that list is the thing to check first — because the blocker is almost never the platform. WABPO supports groups, and it still cannot hand you an OBA; nobody can shortcut that, in the same way nobody can speed up template review.

You cannot add anyone. They have to come in.

This is the second surprise, and it is a design decision rather than an oversight. Meta's reference is blunt about it: since you cannot manually add participants to the group, you send your invite link to the people you would like to join. So a group is never something you assemble from your contact list — it is something people opt into, one tap at a time.

  • Create the group with join approval off, and anyone holding the invite link joins immediately.
  • Create it with join approval on, and people submit join requests that you approve or reject.
  • You can send the invite link as an approved template message, which is how it reaches people at any scale.
  • Resetting the invite link invalidates every previous link. Useful when a link leaks; destructive if you have printed it somewhere.
  • A participant you remove cannot rejoin using an invite link. Removal is closer to a ban than a tidy-up.

What you can manage programmatically

The management surface is small and complete enough to run groups unattended: create and delete a group, get or reset the invite link, send the invite link as a template, approve or reject join requests, remove participants, read a single group's info, list the active groups on a number, and update the subject, description or picture. Messages can also be pinned and unpinned. Those nine operations plus the four webhooks are the whole feature.

When an eight-person group is the right tool

Eight sounds restrictive until you count the people actually involved in a single piece of work. A property viewing is a buyer, perhaps their partner, an agent and a photographer. A vehicle repair is the owner, the service advisor and the technician. A wedding order is the couple, the planner and two people from your side. Those groups are small because the work is small, and the thing they need is not reach — it is everyone seeing the same messages instead of the account manager relaying them.

So the honest test is whether your use case is coordination or distribution. Coordination among a handful of named people, created fresh for each job and deleted when it closes, is exactly what the shape of this API suggests it was built for. Distribution to an audience is broadcasts, and trying to force it into groups will produce ten thousand groups of eight people and a support problem. One more caveat worth stating: Meta's groups messaging documentation does not currently spell out how the 24-hour customer service window applies inside a group, so do not assume group messages behave like one-to-one conversations for pricing or window purposes until that is confirmed.

FAQ

Perguntas frequentes

How many people can be in a WhatsApp group created via the API?

Eight. Meta documents the maximum group participants for the Groups API as 8, which is far below the consumer WhatsApp app's limit of over a thousand. No Business Solution Provider can raise it, so if your plan needs a large group, the Groups API is not the mechanism — broadcasts are.

Can I add contacts to a WhatsApp group through the API?

No. Meta's reference states that you cannot manually add participants, so you send your invite link to the people you want to join and they accept it themselves. Groups are opt-in by design, which also means you cannot rebuild an existing group from a contact list.

Does the Groups API need a special permission from Meta?

Not a special permission — the prerequisite is the standard whatsapp_business_messaging permission you already use for messaging. The real requirement is Official Business Account status for your business, plus a Cloud API number and a webhook server subscribed to the four group fields. OBA is the gate people underestimate.

Can I use groups with the WhatsApp Business app?

No. Groups are not available for WhatsApp Business app phone numbers, or for numbers onboarded to Multi-solution Conversations. The number has to be in use with Cloud API.

How many groups can one business number create?

Up to 10,000 per business phone number. Read that alongside the 8-participant cap and the intended shape becomes clear: many small groups rather than a few large ones — one per order, project, repair or booking.

What happens if I reset a group invite link?

Every previous invite link becomes invalid immediately. That is what you want if a link has leaked beyond the people you intended, and a problem if the old link is printed on something or embedded in a message you already sent. Separately, a participant you remove from a group cannot rejoin using an invite link.

Saifullah Alam

Escrito por

Saifullah Alam

Founder — Spadasoft, WABPO & WAWCD

Saifullah Alam founded Spadasoft, WABPO and WAWCD. He builds WhatsApp Business API products and writes practical, no-hype guides about what actually ships.

Continue lendo