Grupos do WhatsApp e a API em um número com Coexistência
A Groups API da Meta permite que um número da Cloud API crie pequenos grupos só por convite e envie mensagens a eles, mas a Meta afirma que ela não está disponível para números do app do WhatsApp Business, que é o caso de um número com Coexistência. Os grupos já existentes no app também não são sincronizados. Em um número compartilhado, grupos continuam sendo um recurso exclusivo do app.
A Groups API para números do app do WhatsApp Business, ligada pela Meta ao onboarding de Coexistência.
Número máximo de participantes em um grupo criado pela Groups API.
A Groups API é aberta a empresas com uma Official Business Account.
Conversas em grupo em um número conectado a partir do app do WhatsApp Business.
O WhatsApp tem uma Groups API?
Sim. A Groups API da Meta permite que uma empresa crie, liste e atualize grupos em um número da Cloud API, envie mensagens de texto, mídia e template para eles, gerencie o link de convite, aprove ou rejeite pedidos de entrada e remova participantes.
Ela é pequena de propósito. Os grupos são só por convite, com entrada por um link que a empresa envia, e os limites da Meta descrevem algo mais próximo de uma sala de projeto do que de uma comunidade.
- Até 8 participantes por grupo.
- Até 10.000 grupos por número da empresa.
- Uma empresa da Cloud API por grupo.
- Texto, mídia, templates de texto e templates com mídia.
Um número com Coexistência pode usá-la?
Não. A página da Groups API afirma que ela não está disponível para números do app do WhatsApp Business, e essa frase leva ao guia da própria Meta para o onboarding de usuários do app do WhatsApp Business, que é a Coexistência. A condição de elegibilidade também é ter uma Official Business Account, um status que a página de OBA da Meta diz não conceder a números do app do WhatsApp Business.
Portanto, a exclusão é definida pela Meta para todos os provedores. Um número compartilhado entre o app e a API não consegue criar grupos pela API, não consegue enviar mensagens a eles e não recebe eventos de grupo.
O que acontece com os grupos que já estão no app?
Eles ficam no app e continuam funcionando lá. A documentação de Coexistência da Meta lista as conversas em grupo entre o que não é sincronizado quando um número é conectado, então nem o histórico nem as novas mensagens de grupo chegam à API.
A equipe no celular continua podendo criar grupos, publicar neles e lê-los exatamente como antes. O software simplesmente não enxerga esse tráfego. Se um fluxo de trabalho depende de um grupo, como a equipe coordenando entregas, ele segue no app, e qualquer automação em torno dele precisa ser construída a partir de conversas individuais.
O que usar no lugar de grupos pela API?
Conversas individuais, que é em torno do que a plataforma foi construída. Uma mensagem que iria para um grupo de clientes vai para cada um deles individualmente, dentro da janela de atendimento de 24 horas como texto livre, ou fora dela como template aprovado.
Se uma empresa realmente precisa de grupos gerenciados pela API, a Groups API exige um número registrado apenas na Cloud API e com uma Official Business Account, o que significa sair da Coexistência para esse número. É uma decisão estrutural sobre o número, não uma configuração, e ela remove o app dele.
Erros comuns
- Ler que existe uma Groups API e supor que ela vale para um número com Coexistência. A Meta exclui os números do app Business.
- Esperar que o histórico de grupos apareça na API após o onboarding. As conversas em grupo não são sincronizadas.
- Planejar um fluxo baseado em grupos em torno de um limite de 8 participantes sem verificar se ele cabe.
A EasyCoexistence conecta números pelo onboarding de Coexistência da Meta, então o comportamento dos grupos é exatamente o que a Meta define: os grupos ficam no app, e as conversas individuais passam pela API.
Perguntas frequentes
Posso enviar uma mensagem a um grupo do WhatsApp pela API?
Só a partir de um número exclusivo da API com uma Official Business Account, usando a Groups API. Não a partir de um número com Coexistência.
Meus grupos atuais continuam funcionando?
Sim, no app do WhatsApp Business. Eles não são sincronizados com a API.
Quantas pessoas podem entrar em um grupo da API?
A Meta limita os grupos criados pela Groups API a 8 participantes.
Isso é um limite do meu provedor?
Não. A Meta define a exclusão dos números do app do WhatsApp Business em todos os provedores.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em