Webhooks do WhatsApp explicados sem jargão
Webhook é o jeito da Meta avisar sua plataforma de que algo aconteceu: chegou mensagem, a mensagem foi entregue, o template foi aprovado, a qualidade do número mudou.
6 min de leitura · atualizado em
Os eventos que importam
Na prática, quatro grupos resolvem quase tudo em uma operação comercial.
- Mensagens recebidas: texto, mídia, áudio, localização e resposta de botão.
- Status de mensagem: enviada, entregue, lida e falha, com código de erro.
- Templates: aprovação, rejeição e mudança de categoria.
- Conta: mudança de qualidade, de faixa de envio e restrições.
Entrega confiável
A Meta reenvia notificações quando seu endpoint não responde rápido. Isso significa que o mesmo evento pode chegar duas vezes — a plataforma precisa tratar duplicatas por identificador de mensagem.
Responder o webhook em milissegundos e processar depois, em fila, é a arquitetura que evita perda e reenvio em cascata.
O que fazer com status de mensagem
Status é o que transforma disparo em métrica: taxa de entrega revela número inválido, taxa de leitura revela relevância e código de falha revela problema de template ou de janela.