Equipe Periskope
A API de grupos do WhatsApp permite que empresas criem e gerenciem grupos do WhatsApp via código, pela WhatsApp Business Platform.
Para ter acesso, você precisa de uma Conta Comercial Oficial (OBA) e de um número compatível na Cloud API. A API também tem limites rígidos de tamanho de grupo, criação de grupos, gestão de participantes e envio de mensagens.
Neste guia você vai ver quem pode usar a API de grupos, o que a Meta exige para a OBA, os limites atuais, como funciona a cobrança e o que fazer se a API não servir para o seu caso.
Resumo rápido: a API de grupos do WhatsApp em números
Quem pode usar a API de grupos do WhatsApp?
Para usar a API de grupos, sua empresa precisa ter uma Conta Comercial Oficial (OBA).
Só que ter uma conta verificada no Meta Business, um nome de exibição aprovado no WhatsApp ou acesso à WhatsApp Business Platform não transforma sua empresa automaticamente em OBA.
1. O que é OBA?
A Meta concede o status de OBA a empresas consolidadas e conhecidas no WhatsApp. Na análise, ela leva em conta, entre outros pontos:
A verificação da empresa
Um nome de exibição aprovado
A confirmação em duas etapas no número de telefone
Há quanto tempo a empresa está ativa na WhatsApp Business Platform
Se a empresa tem uma presença relevante e autêntica
Ser elegível para OBA é diferente de só concluir a verificação da empresa.
2. O selo de OBA vs o status real na API
Se você confere a elegibilidade pela API, vale ficar de olho em mais um detalhe.
O WhatsApp expõe mais de um campo ligado ao status da conta comercial, entre eles is_official_business_account e oba_status. E eles nem sempre dizem a mesma coisa.
Uma conta pode aparecer como conta comercial oficial em um campo enquanto o oba_status não mostra uma OBA ativa.
Se você está montando uma verificação automática de elegibilidade, não dependa de um único campo booleano. Confira o status real de OBA que a API retorna para a empresa e confirme que o número e a conta cumprem os requisitos da API de grupos.
Isso importa porque, do contrário, um painel ou uma integração pode mostrar a empresa como "oficial" quando a conta ainda não consegue usar a API de grupos.
3. Você precisa de um número na Cloud API
A API de grupos funciona com números da WhatsApp Cloud API.
Um número que roda no app WhatsApp Business não pode usar a API de grupos. Hoje a Meta também não oferece a API de grupos com Coexistence (coexistência).
Então, se a empresa gerencia o número pelo app WhatsApp Business, não basta conectar essa mesma configuração à API de grupos. O número precisa estar configurado na Cloud API.
Checklist rápido de elegibilidade Antes de desenvolver em cima da API de grupos, confirme que:
|
|---|
Try Periskope
Gerencie grupos, conversas e números do WhatsApp em escala
Quais são os limites e restrições da API de grupos do WhatsApp?
Depois que a empresa se qualifica, a próxima pergunta é se a API encaixa no seu fluxo de trabalho de verdade.
1. Até 8 participantes por grupo
Um grupo da API de grupos aceita até 8 participantes, contando o número da empresa. Sobra espaço para no máximo 7 pessoas.
Por isso, a API funciona melhor em conversas pequenas e focadas do que em grandes comunidades de clientes.
Por exemplo:
Um cliente + a equipe de suporte
Uma equipe pequena de projeto
Um revendedor + os gerentes de conta
Um grupo pequeno de clientes passando pelo onboarding
Se você precisa de um grupo de WhatsApp com 50 ou 500 membros, esse limite já descarta a API de grupos.
2. Até 10.000 grupos por número comercial
Um único número comercial da API do WhatsApp pode criar até 10.000 grupos pela API de grupos.
Mais uma regra: cada grupo só pode pertencer a uma empresa da Cloud API. Duas contas comerciais diferentes não podem compartilhar nem administrar juntas o mesmo grupo.
3. Os participantes entram por convite
A API de grupos não deixa a empresa adicionar participantes diretamente.
Quando você cria um grupo, o WhatsApp gera um link de convite. Você envia esse link para quem deve participar e, se quiser analisar os pedidos antes de as pessoas entrarem, pode ativar a aprovação de solicitações de entrada.
Uma imobiliária em Curitiba, por exemplo, poderia criar um grupo para um cliente novo e mandar o link de convite por um template aprovado do WhatsApp.
4. Só 3 mensagens podem ficar fixadas
A API de grupos permite fixar mensagens, com no máximo 3 mensagens fixadas por grupo.
Se você fixar uma quarta, o WhatsApp desafixa automaticamente a mais antiga. Cada mensagem pode ficar fixada de 1 a 30 dias.
5. A API de grupos tem limites de taxa próprios
As operações da API de grupos têm limites de taxa (rate limits) próprios. Se um número fizer operações demais em grupos em pouco tempo, a API pode retornar o erro 131208, Group Rate Limit Hit.
Isso não tem a ver com a capacidade geral de envio de mensagens da Cloud API. Ter uma capacidade de envio alta não elimina os limites de operação da API de grupos.
6. A Meta pode bloquear temporariamente a criação de grupos
A Meta pode impedir temporariamente que uma empresa crie novos grupos se detectar excesso de mensagens de marketing enviadas pela WABA dentro da janela de atendimento ao cliente nos 7 dias anteriores.
Isso aparece como erro 131214.
Se o seu fluxo depende muito de criar grupos novos, inclua esse limite no planejamento.
Como funciona a cobrança da API de grupos do WhatsApp?
Na Cloud API do WhatsApp comum, você paga por cada mensagem entregue à pessoa com quem fala (desde 1º de julho de 2025, a Meta cobra por mensagem, e não mais por conversa de 24 horas).
Uma pessoa, uma mensagem cobrada.
Nos grupos, a conta muda.
Quando você manda uma mensagem em um grupo, o WhatsApp cobra uma entrega separada para cada pessoa do grupo, e não uma mensagem só.
Ou seja: mandar um aviso em um grupo cheio de 8 pessoas (sua empresa mais 7) conta como 7 entregas cobradas, não 1.
Exemplo: uma empresa que manda 100 avisos por mês em um grupo cheio de 8 pessoas não paga por 100 mensagens. Paga por até 700 entregas, o mesmo gasto de mandar 700 mensagens individuais.
O custo cresce com o total de pessoas alcançadas em todos os seus grupos, não com quantas vezes você aperta enviar. A partir de 1º de outubro de 2026, as mensagens de atendimento (respostas livres dentro da janela de 24 horas) também passam a ser cobradas depois das primeiras 1.000 gratuitas por número comercial a cada mês, pela tarifa de utilidade do mercado. Veja o que mudou em 1º de outubro.
O que fazer se você não se qualifica ou se os limites ficam pequenos
Se a sua empresa ainda não tem status de OBA, usa o app WhatsApp Business ou está em Coexistence, a API de grupos não está disponível para você agora, por mais bem montado que esteja o resto da sua operação.
E mesmo com OBA, o limite de 8 participantes descarta qualquer coisa maior que um grupo pequeno e bem definido.
Um escalonamento de suporte com meia dúzia de pessoas funciona. Uma comunidade, uma turma ou um grupo de clientes de tamanho real, não.
Se você já tem grupos ativos no WhatsApp, o Periskope permite que sua equipe gerencie todos eles em escala.
Ele conecta números comuns do WhatsApp e do WhatsApp Business pelos aparelhos conectados, e a equipe passa a gerenciar os grupos e conversas que esses números já usam.
Você leva essas conversas para um workspace compartilhado, atribui tickets e tarefas, distribui mensagens entre os atendentes, automatiza fluxos e gerencia milhares de grupos do WhatsApp em um só lugar.
É a opção certa para empresas que já têm grupos ativos no WhatsApp e querem gerenciá-los em equipe, em vez de criar grupos novos pela API de grupos.
Para comparar as duas abordagens em detalhe, leia Grupos comuns do WhatsApp vs API de grupos do WhatsApp.
Perguntas frequentes
1. O que significa ter uma Conta Comercial Oficial (OBA) no WhatsApp?
OBA é um status que a Meta concede a empresas consolidadas e conhecidas na WhatsApp Business Platform.
Ela exige verificação da empresa, nome de exibição aprovado, confirmação em duas etapas e histórico na plataforma, mas cumprir esses pontos não garante o status de OBA por si só.
2. Minha empresa aparece como verificada. Por que ainda não consigo acessar a API de grupos?
Verificação da empresa e status de OBA não são a mesma coisa. Confira direto o campo oba_status em vez de confiar no selo, que pode aparecer pelo Meta Verified sem a aprovação completa de OBA.
3. Posso usar a API de grupos do WhatsApp com o app WhatsApp Business?
Não. A API de grupos exige um número padrão da Cloud API. Ela não está disponível para números do app Business nem para configurações em Coexistence.
4. A API de grupos do WhatsApp exige 100.000 mensagens por dia?
Não. A documentação atual da Meta sobre a API de grupos não lista um mínimo de 100.000 mensagens como requisito à parte. O status de OBA é o principal requisito da conta comercial, junto com a configuração na Cloud API.
5. Quantos grupos um número comercial do WhatsApp pode criar?
Até 10.000 grupos por número comercial.
6. Como é calculada a cobrança da API de grupos do WhatsApp?
Por destinatário, não por mensagem enviada. Uma mensagem para um grupo de 8 pessoas é cobrada como até 7 entregas, não uma.
7. Por que não consigo adicionar um participante direto em um grupo da API de grupos?
Não existe endpoint para adicionar participantes. As pessoas entram por um link de convite, que elas mesmas precisam aceitar.
8. Posso migrar um grupo do WhatsApp que já existe para a API de grupos?
Não. A API de grupos foi feita para criar grupos novos gerenciados pela API e não oferece como importar um grupo que já existe nem a lista de membros dele. Se você já tem grupos ativos no WhatsApp, o Periskope gerencia esses grupos sem exigir nenhuma migração.
Teste grátis e veja como funciona nos seus próprios grupos.
