A API oficial do WhatsApp funciona de forma assíncrona: para enviar mensagem, a empresa chama a API da Meta; para receber mensagem ou saber o que aconteceu com um envio, a Meta chama de volta um endereço configurado pela empresa. Esse mecanismo de callback é o webhook. Sem ele configurado corretamente, mensagens recebidas simplesmente não chegam a lugar nenhum visível, ficam registradas no lado da Meta, mas não são entregues à aplicação da empresa.
A configuração exige uma URL pública, com HTTPS válido, e um token de verificação combinado no momento da inscrição do webhook. A Meta faz uma chamada de validação nessa URL antes de começar a enviar eventos de verdade, e depois passa a notificar a cada novo evento relevante.
Principais tipos de evento enviados por webhook:
- Mensagens recebidas de contatos, incluindo texto, mídia, localização e respostas de botão
- Atualizações de status de mensagens enviadas: enviada, entregue, lida ou com falha
- Mudanças na classificação de qualidade do número
- Aprovação, rejeição ou pausa de templates
- Eventos de conta, como mudança de tier ou alerta de política comercial
Próximo passo
Quer operar na API oficial sem risco de bloqueio?
O Nevoa Manager conecta seu número pela WhatsApp Cloud API, com templates, disparos, atendimento e rastreamento de campanhas até a venda.