API oficial do WhatsApp para grupos: o que ela faz e quando não serve

O que é a Groups API do WhatsApp

A Groups API é um recurso da Cloud API, a plataforma oficial da Meta para empresas conversarem com clientes no WhatsApp. Segundo a documentação oficial da Groups API, ela permite criar grupos por programação, para troca de mensagens e colaboração, e hoje está aberta a todas as empresas que têm uma Conta Comercial Oficial (OBA).

O funcionamento é diferente de um grupo comum. O grupo é sempre por convite: a empresa cria o grupo, gera um link de convite e envia esse link para as pessoas, que decidem se querem entrar. O próprio link mostra o contexto do grupo antes da entrada. Não existe a opção de "adicionar" alguém direto pela API.

Os limites da Groups API em uma tabela

Dados conferidos na documentação da Meta em 9 de outubro de 2026:

Quem pode usar: a exigência da Conta Comercial Oficial

O ponto que mais barra empresas é a OBA. De acordo com a página da Meta sobre Contas Comerciais Oficiais, o status é concedido a números de empresas verificadas como autênticas, e os critérios incluem:

• cumprir a Política de Mensagens Comerciais do WhatsApp;
• estar registrada na WhatsApp Business Platform há pelo menos 30 dias;
• ter o portfólio empresarial verificado pela Meta;
• ter a verificação em duas etapas ativa no número;
• ter o nome de exibição do número aprovado.

A Meta também informa que não concede OBA a números de funcionários, contas de teste e números do app WhatsApp Business. Se o pedido for negado, é preciso esperar 30 dias para pedir de novo. Na prática, isso deixa de fora a maioria dos administradores de grupos, criadores e pequenos negócios que usam o WhatsApp no celular.

Como funciona na prática

Para quem tem acesso, o fluxo típico descrito na documentação é este:

1. A empresa cria o grupo pela API, com nome e descrição.
2. Gera o link de convite do grupo (e pode redefini-lo quando quiser).
3. Envia o link para o cliente, inclusive por um modelo de mensagem com o convite.
4. O cliente entra pelo link. Se os pedidos de entrada estiverem ativos, a empresa aprova ou recusa cada pedido.
5. A partir daí, a empresa envia e recebe mensagens no grupo, fixa e desafixa mensagens e recebe os eventos por webhooks.
6. Quando a conversa termina, a empresa pode remover participantes, atualizar as configurações ou apagar o grupo.

Ou seja, é um recurso para desenvolvedores: exige integração com a Cloud API, um servidor para receber webhooks e alguém para manter o código.

O que a Groups API não faz

A lista de recursos não suportados é longa e pesa na decisão. Pela documentação, nos grupos da API não há:

• chamadas de voz ou vídeo (a Calling API não é suportada);
• mensagens temporárias e de visualização única;
• mensagens interativas (botões e listas), de comércio e de autenticação;
• edição e exclusão de mensagens;
• a opção de admin de ocultar a lista de participantes.

Outros dois detalhes: as métricas de desempenho de modelos não ficam disponíveis em grupos, e a Meta recomenda criar modelos específicos para uso em grupo. E, como a cobrança é por mensagem, um grupo muito ativo custa mais.

Para quem a API oficial de grupos faz sentido

Com 8 participantes no máximo, os bons usos são conversas de atendimento em que várias pessoas precisam ver a mesma coisa:

• uma conta empresarial em que o cliente fala com o consultor e o gerente no mesmo grupo;
• suporte técnico com o cliente, o fornecedor e o técnico;
• concierge de viagens, imóveis ou eventos para uma família ou pequeno grupo;
• onboarding de um cliente B2B com a equipe do projeto.

Agora, se o seu caso é um grupo de alunos, de ofertas, de condomínio, de igreja ou de notícias, com dezenas ou centenas de pessoas, a Groups API não atende, seja pelo limite de participantes, seja pela falta de moderação. Para entender os limites dos grupos comuns, veja o guia de limite de participantes do WhatsApp.

Alternativas para administrar grupos grandes

Para comunidades, o caminho continua sendo o próprio app do WhatsApp, com ou sem ajuda de ferramentas:

• Grupos e comunidades nativos: grupos grandes, comunidades que reúnem vários grupos e um grupo de avisos. Veja a diferença entre comunidade, grupo e canal.
• Canais: para comunicação de um para muitos, sem conversa.
• Bots de grupo conectados como dispositivo: ferramentas como o 9bot se conectam ao seu número pelo recurso de dispositivos conectados, com QR code ou código de pareamento, e atuam nos grupos em que você é admin (moderação, agendamentos, boas-vindas, relatórios).

Sobre a terceira opção, vale ser transparente: ela não é a Cloud API. Pela Central de Ajuda (dispositivos conectados), você pode conectar até quatro dispositivos ao celular principal; eles funcionam mesmo com o celular offline, mas são desconectados se o celular ficar mais de 14 dias sem uso. A mesma página alerta que conectar a conta a apps ou sites não oficiais pode levar a banimento, e o WhatsApp não permite mensagens automatizadas ou em massa. Por isso, use automação para organizar o grupo, não para disparar mensagens. Comparamos os riscos de cada tipo de ferramenta no artigo bot para grupo de WhatsApp: grátis ou pago.

Groups API x bot de grupo: comparativo

Quer conectar uma IA, como ChatGPT ou Claude, aos seus grupos? O 9bot MCP permite que assistentes consultem grupos, gerem relatórios e criem Workflows dentro das permissões que você define.

Como decidir em 3 perguntas

1. Seus grupos têm mais de 8 pessoas? Se sim, a Groups API está descartada.
2. Você tem Conta Comercial Oficial e um time de desenvolvimento? Se não, também.
3. Você precisa moderar (apagar mensagens, remover quem manda link)? A API não apaga mensagens; um bot de grupo ou a moderação manual resolvem.

Se a API oficial não for o seu caso, veja tudo o que o 9bot faz nos grupos e teste num grupo pequeno antes de levar para os grandes.

Leia também

Perguntas frequentes