Grupos do WhatsApp e a API num número com Coexistence
A Groups API da Meta permite a um número da Cloud API criar pequenos grupos apenas por convite e enviar-lhes mensagens, mas a Meta indica que não está disponível para números de telefone da app WhatsApp Business, que é o caso de um número com Coexistence. Os grupos já existentes na app também não são sincronizados. Num número partilhado, os grupos continuam a ser uma funcionalidade exclusiva da app.
A Groups API para números de telefone da app WhatsApp Business, associada pela Meta ao onboarding da Coexistence.
Número máximo de participantes num grupo criado através da Groups API.
A Groups API está aberta a empresas com uma Official Business Account.
Conversas de grupo num número registado a partir da app WhatsApp Business.
O WhatsApp tem uma Groups API?
Sim. A Groups API da Meta permite a uma empresa criar, listar e atualizar grupos num número da Cloud API, enviar-lhes mensagens de texto, multimédia e templates, gerir a ligação de convite, aprovar ou rejeitar pedidos de adesão e remover participantes.
É deliberadamente pequena. Os grupos são apenas por convite, com adesão através de uma ligação enviada pela empresa, 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 de empresa.
- Uma empresa da Cloud API por grupo.
- Texto, multimédia, templates baseados em texto e templates baseados em multimédia.
Um número com Coexistence pode usá-la?
Não. A página da Groups API indica que não está disponível para números de telefone da app WhatsApp Business, e essa expressão remete para o guia da própria Meta sobre o onboarding de utilizadores da app WhatsApp Business, ou seja, a Coexistence. A condição de elegibilidade é também uma Official Business Account, um estatuto que, segundo a página da Meta sobre a OBA, não é atribuído a números de telefone da app WhatsApp Business.
Portanto, a exclusão é definida pela Meta para todos os fornecedores. Um número partilhado entre a app e a API não pode criar grupos através da API, não pode enviar mensagens para eles e não recebe eventos de grupo.
O que acontece aos grupos que já estão na app?
Ficam na app e continuam a funcionar aí. A documentação da Meta sobre a Coexistence inclui as conversas de grupo entre o que não é sincronizado quando um número é registado, pelo que nem o histórico nem as novas mensagens de grupo chegam à API.
A equipa que está ao telemóvel pode continuar a criar grupos, a publicar neles e a lê-los exatamente como antes. O software simplesmente não tem visibilidade desse tráfego. Se um fluxo de trabalho depender de um grupo, como a coordenação de entregas pelos colaboradores, continua na app, e qualquer automatização em torno dele tem de ser construída a partir de conversas individuais.
O que devo usar em vez de grupos através da API?
Conversas individuais, que é aquilo em torno do qual a plataforma foi construída. Uma mensagem que iria para um grupo de clientes é enviada a cada um deles individualmente, dentro da janela de atendimento ao cliente de 24 horas como texto livre, ou fora dela como template aprovado.
Se uma empresa precisar mesmo de grupos geridos pela API, a Groups API exige um número registado apenas na Cloud API e com uma Official Business Account, o que significa abandonar a Coexistence nesse número. É uma decisão estrutural sobre a linha, não uma definição, e retira-lhe a app.
Erros comuns
- Ler que existe uma Groups API e presumir que abrange um número com Coexistence. A Meta exclui os números da app Business.
- Esperar que o histórico de grupos apareça na API após o onboarding. As conversas de grupo não são sincronizadas.
- Planear um fluxo de trabalho baseado em grupos em torno de um limite de 8 participantes sem verificar se é suficiente.
A EasyCoexistence liga números através do onboarding de Coexistence da Meta, pelo que o comportamento dos grupos é exatamente o que a Meta define: os grupos ficam na app e as conversas individuais passam pela API.
Perguntas frequentes
Posso enviar uma mensagem para um grupo do WhatsApp através da API?
Só a partir de um número exclusivo da API, com uma Official Business Account, através da Groups API. Não a partir de um número com Coexistence.
Os meus grupos existentes continuam a funcionar?
Sim, na app WhatsApp Business. Não são sincronizados com a API.
Quantas pessoas podem entrar num grupo da API?
A Meta limita os grupos criados através da Groups API a 8 participantes.
Este limite é do meu fornecedor?
Não. A Meta define a exclusão dos números da app WhatsApp Business em todos os fornecedores.
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em