Configurar na Meta
Meta Developers: configurar o webhook do WhatsApp
Direcione eventos de mensagens para o servidor do Omnichannel.
Onde encontrarDevelopers → aplicativo → WhatsApp → Configuração / Webhooks
Antes de começar
- Atividade do administrador da empresa ou do responsável técnico autorizado.
- Tenha acesso aos ativos da sua própria empresa. Os nomes de menus externos podem variar conforme a versão e o idioma.
Passo a passo
- Solicite ao responsável técnico a URL HTTPS pública exata de recepção e o token de verificação configurado no Omnichannel. Não use o domínio da wiki.
- Na configuração de webhook do produto WhatsApp, informe a URL e o token de verificação correspondentes e execute a validação.
- No objeto WhatsApp Business Account, confira a assinatura do campo messages e dos eventos adicionais que o administrador indicar para os recursos utilizados.
- No Omnichannel, execute a ativação/verificação para confirmar a assinatura do aplicativo na WABA correta. Salvar a URL no aplicativo e assinar a conta são verificações diferentes.
- Se já havia outro fornecedor, solicite revisão dos callbacks específicos do número e da WABA: um override pode prevalecer sobre o callback geral do aplicativo.
- Homologue com uma conversa de teste autorizada. Confira tanto a chegada ao painel quanto o status de resposta e os registros de webhook.
Resultado esperado
Eventos da WABA correta chegam ao Omnichannel e o diagnóstico confirma a assinatura.
Observações importantes
- O token de verificação apenas valida o callback; ele não é o token de acesso à Graph API.
- Uma nova assinatura manual pode afetar overrides existentes; prefira o procedimento de ativação da instalação.
Se precisar de ajuda
- Validação recusada: confira HTTPS, URL, token e acesso público ao endpoint.
- Validação aceita sem mensagens: confira assinatura da WABA, overrides e número selecionado.