Grupos na API Oficial do WhatsApp: o estado atual (e por que só quem tem OBA entra)

Durante anos a resposta para “dá para mexer em grupo pela API oficial?” foi um não seco. Quem precisava disso ia para API não oficial e assumia o risco de ban.

Isso mudou. A Meta liberou o Groups API dentro da Cloud API, com endpoints de verdade: criar grupo, gerar e revogar link de convite, remover participante, fixar mensagem, atualizar configuração e receber webhook de entrada e saída de gente.

E aí vem a parte que quase todo material de fornecedor esconde no rodapé: o recurso é liberado apenas para contas com Official Business Account (OBA), e cada grupo comporta 8 participantes. Não 256. Não 1.024. Oito.

Esse artigo é o estado atual: o que existe, quem consegue usar, quanto custa e quais casos de uso sobrevivem a esses dois limites.

Escopo: grupos via Cloud API oficial. Não cobre API não oficial nem o app WhatsApp Business. Para a diferença entre os caminhos, veja Cloud API vs coexistência.

O muro 1: OBA, não faturamento

A regra de elegibilidade tem uma linha só na documentação da Meta: a conta precisa ser um Official Business Account. É o selo ao lado do nome do remetente, o mesmo que discutimos no artigo sobre o selo azul.

Os critérios formais do OBA são estes:

Cumprir os cinco não garante nada. O filtro real, o que os BSPs relatam na prática, é notoriedade de marca: a Meta quer ver a empresa citada com frequência em veículos de imprensa reputados. É por isso que o OBA na prática recai sobre marcas grandes, e é por isso que a maioria dos times que lê esse site não vai passar tão cedo.

Dois detalhes que fecham mais a porta:

• Números do app WhatsApp Business (o comercial de consumidor) estão fora, por definição.
• Números em Multi-solution Conversations também estão fora.
• A solicitação de OBA hoje normalmente é submetida pelo BSP em nome do cliente, não pelo próprio negócio.

O mito dos 100 mil disparos

Circula em vários guias em inglês que o Groups API exige “100 mil conversas iniciadas pela empresa em 24 horas”. Esse requisito não existe na documentação da Meta. A régua publicada é o OBA, e só.

Provavelmente é herança de um piloto fechado antes da abertura geral. Se um fornecedor usar esse número para justificar por que você não pode ter o recurso, o dado está errado. O motivo verdadeiro é mais simples e mais duro: falta selo.

O muro 2: 8 participantes

Esse limite é o que define quais casos de uso fazem sentido, e é onde a maioria dos planos morre.

Oito participantes mata de saída qualquer ideia de comunidade, canal de avisos ou grupo de turma. O desenho da Meta aqui não é broadcast, é atendimento multiparte: a conversa em que o cliente, um acompanhante e dois atendentes precisam estar na mesma thread.

Os 10.000 grupos por número compensam na largura o que falta na profundidade. O modelo mental correto é 10.000 salas pequenas, não um auditório.

Casos que cabem em 8 pessoas de verdade:

• Casal ou família fechando compra alta (imóvel, viagem, procedimento).
• Cliente, corretor e vistoriador em um sinistro.
• Comprador, vendedor e despachante em uma transferência.
• Empresa cliente com dois ou três contatos, mais dois do seu time.
• Resolução de caso que hoje vive em três conversas 1:1 e perde contexto.

Casos que não cabem, e continuam sendo lista de transmissão ou template em massa: turma de curso, condomínio, base de leads, comunidade.

Como funciona na prática

Convite, nunca adição

Ponto arquitetural mais importante: você não adiciona ninguém a um grupo. Não existe endpoint para isso. O usuário entra por link de convite, por escolha própria.

Mais: a distribuição do link precisa sair em um template aprovado da Template Library. Ou seja, o opt-in é estrutural, não uma boa prática opcional. Só depois que o webhook confirma a entrada é que a pessoa passa a receber mensagens do grupo.

Isso resolve, de saída, o problema clássico de grupo de WhatsApp comercial: ninguém é jogado dentro sem consentimento.

Endpoints

Link de convite:

# criar ou resetar
curl -X POST 'https://graph.facebook.com/v25.0/{group_id}/invite_link' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{}'

# revogar
curl -X DELETE 'https://graph.facebook.com/v25.0/{group_id}/invite_link' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{}'

Resposta do POST:

{
  "messaging_product": "whatsapp",
  "invite_link": "https://chat.whatsapp.com/LINK_ID"
}

Enviar mensagem para o grupo usa o mesmo endpoint de sempre, mudando duas chaves:

{
  "messaging_product": "whatsapp",
  "recipient_type": "group",
  "to": "<GROUP_ID>",
  "type": "text",
  "text": {
    "preview_url": true,
    "body": "Segue o contrato revisado."
  }
}

O recipient_type: "group" é a chave que muda tudo. O to recebe o group ID devolvido pela criação do grupo, não um telefone.

Fixar mensagem:

{
  "messaging_product": "whatsapp",
  "recipient_type": "group",
  "to": "<GROUP_ID>",
  "type": "pin",
  "pin": {
    "type": "pin",
    "message_id": "<MESSAGE_ID>",
    "expiration_days": 4
  }
}

Só admin fixa ou desafixa.

Webhooks e permissão

Antes de qualquer chamada, o app precisa da permissão whatsapp_business_messaging e da assinatura destes quatro campos:

Sem assinar isso, você cria o grupo e fica cego: não sabe quem entrou, e portanto não sabe quando pode falar.

O que não dá

Tentar enviar um tipo não suportado devolve erro 130501: “Message type is not currently supported”.

A perda das interativas dói mais do que parece. Todo fluxo de triagem construído sobre botões e listas precisa ser reescrito em texto puro dentro do grupo. Se o seu bot depende de quick replies para roteamento, ele não atravessa a fronteira do grupo do jeito que está.

E métricas de performance de template não são reportadas para templates usados em grupos. Você perde a leitura de entrega e engajamento que usa para otimizar campanha.

O ponto de LGPD que ninguém comenta

A lista de participantes não pode ser ocultada pelo admin. Em um grupo com 8 pessoas, todo mundo vê o número de telefone de todo mundo.

Se você juntar dois clientes que não se conhecem na mesma sala, você acabou de compartilhar dado pessoal de um com o outro, sem base legal óbvia e sem consentimento específico. Grupo entre partes de um mesmo caso (a família, os dois compradores) é uma coisa. Grupo juntando clientes distintos é outra bem diferente, e é onde mora o risco.

Regra prática: um grupo por caso, com quem já se conhece fora do WhatsApp.

A conta: você paga por destinatário

Aqui está a parte que muda o business case.

Grupos seguem o pricing por mensagem da Cloud API, cobrado por destinatário entregue, na tarifa do país de cada um. Um template enviado para um grupo com 5 pessoas e entregue às 5 gera 5 cobranças, não uma.

Ou seja: grupo não é desconto de volume. O custo por template escala linear com o tamanho da sala. Enviar para um grupo cheio de 8 pessoas custa 8 vezes o envio individual.

O que grupo economiza é operação, não verba: uma thread em vez de quatro, contexto compartilhado, menos repetição de informação pelo atendente. Se a justificativa do projeto for redução de custo de mensagem, a conta não fecha. Se for redução de retrabalho e tempo de resolução, pode fechar bem.

A janela de 24 horas continua valendo com a lógica de sempre: fora dela, só template, e template é evento cobrado. Detalhes em janela de 24 horas e categorias.

Resumo do estado atual

FAQ

Não tenho OBA. Tem contorno? Não pela via oficial. O caminho é submeter o pedido de OBA pelo seu BSP e trabalhar os pré-requisitos: 30 dias de plataforma, Business Verification aprovada, 2FA no número, display name aprovado. A notoriedade de imprensa é a parte que não se resolve com configuração, e é a que costuma travar.

Consigo migrar meus grupos atuais do app para a API? Não. Grupos criados fora nascem em outro contexto e o Groups API opera sobre grupos que ele mesmo cria, com uma empresa Cloud API por grupo.

Dá para colocar dois números da minha empresa no mesmo grupo? Não. O limite é uma empresa Cloud API por grupo.

Se um participante mandar mensagem, abre janela de serviço? A mensagem de entrada segue a lógica de conversa da plataforma. O que muda é que a cobrança de saída é multiplicada pelos destinatários entregues, então planeje o template pensando no tamanho da sala.

Vale trocar minha API não oficial por isso? Só se o seu caso couber em 8 pessoas, sem botões e sem adição direta de participantes. Grupo grande, comunidade e adição em massa continuam sendo território exclusivo de solução não oficial, com o risco de bloqueio que sempre teve.

O recurso ainda é beta? O rollout via BSPs começou em outubro de 2025 e a documentação da Meta hoje descreve o recurso como aberto a todas as contas com OBA, sem menção a beta ou lista de espera.

Referências: Groups API, Group messaging, Official Business Accounts. Limites e disponibilidade mudam sem aviso. Confirme na documentação da Meta antes de fechar escopo com cliente.

Conteúdo da comunidade WhatsApp Founders 🇧🇷. Independente, sem vínculo oficial com o WhatsApp ou a Meta.