Meta Tech Provider

whatsapp-business-account | A Conta do WhatsApp Business, e por que os overrides ficam nela

Uma Conta do WhatsApp Business guarda números de telefone e templates. Ela importa mais do que parece porque o roteamento de webhook é aplicado nesse nível, e não por número, e é por isso que remover uma conexão leva o roteamento junto.

1

Override de webhook por Conta do WhatsApp Business, e não por número.

PARTNER_REMOVED

O evento que desinstala o app e o override ao mesmo tempo.

250

O número máximo de templates numa conta, definido pela Meta.

O que uma WABA guarda de verdade?

Números de telefone e templates, que é uma dupla com mais consequências do que parece à primeira vista.

Templates pertencem à conta, e não a um número, então todo número na mesma WABA compartilha a mesma biblioteca de templates. Crie um para avisos de pedido e todos eles podem enviar. A Meta limita a quantidade de templates numa conta, e esse é um limite que agências com muitas marcas numa conta só conseguem alcançar.

Cada número carrega o próprio phone number id, nome de exibição, classificação de qualidade e nível de mensagens. Esses são por número, então um pode estar degradado enquanto outro da mesma conta está saudável.

Por que os overrides de webhook ficam nesse nível?

Porque a inscrição que eles modificam é a inscrição de um app numa conta, e não num número.

Quando um destino é definido, o que de fato acontece é que uma override callback URI é aplicada à inscrição do nosso app naquela WABA. A partir daí, todo número da conta entrega ali os eventos do caminho de mensagens. Não existe roteamento por número, o que surpreende quem administra vários números sob um mesmo cliente.

A consequência é a que vale planejar. Quando uma conexão é removida, pela regra de quatorze dias de inatividade ou por outro motivo, o app é desinstalado da conta e o override é desinstalado junto. O envio e o monitoramento voltam na reconexão. A entrega no seu próprio servidor não volta, a menos que alguma coisa recoloque o override.

Erros comuns

  • Esperar roteamento de webhook por número. O override é por conta.
  • Achar que uma reconexão restaura o destino. Ele é desinstalado junto com o app e precisa ser reaplicado.
  • Esquecer que os templates são compartilhados. Todo número da conta enxerga a mesma biblioteca.
Fazendo isso com o EasyCoexistence

A EasyCoexistence reaplica um override de webhook automaticamente depois de qualquer reconexão, porque o comportamento que torna isso necessário já custou a entrega de mensagens de um número real.

Perguntas frequentes

Dois números numa mesma WABA podem rotear para endpoints diferentes?

Não. O override se aplica à conta, então todos os números dela entregam no mesmo destino.

Templates são transferidos entre contas?

Não. Eles pertencem à conta em que foram criados.

O que acontece com o override quando um número é removido?

Se o app for desinstalado da conta, o override vai junto. Reconectar restaura o envio, mas não o destino.

Existe um limite de templates?

A Meta limita os templates por conta, e ultrapassar esse limite devolve um erro específico.

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átis

Verificado em

Conta do WhatsApp Business