Webhook (WhatsApp Business)
Endpoint HTTPS que recebe notificações em tempo real do WhatsApp Business API quando algo acontece (mensagem chega, status muda, etc).
Também conhecido como: webhook WhatsApp · webhook Meta · webhook Business API · evento WhatsApp
Um webhook no contexto WhatsApp Business é uma URL HTTPS hospedada pela empresa (ou pela plataforma de CRM) que a Meta chama sempre que algo relevante acontece com o número conectado à API. É o mecanismo de "notificação push" da plataforma.
Eventos webhook mais comuns: - messages: chegou uma mensagem nova (texto, imagem, áudio, documento, localização, contato, sticker). - message_status: mensagem enviada pela empresa mudou de status (sent → delivered → read → failed). - account_alerts: avisos sobre o número (quality rating mudou, tier subiu/desceu, número está em revisão). - template_status_update: template submetido foi aprovado/rejeitado/pausado. - business_capability_update: limites de envio mudaram.
Como funciona tecnicamente: 1. Empresa configura URL do webhook no Meta Business Manager. 2. Meta envia POST HTTPS pra essa URL toda vez que evento acontece. 3. Empresa responde 200 OK em até 10 segundos. Se não responder, Meta tenta novamente com backoff exponencial e eventualmente desativa o webhook. 4. Empresa processa o payload e age (cria contato, dispara automação, atualiza dashboard).
Segurança: - Meta assina cada request com HMAC-SHA256 usando o "App Secret" — empresa deve validar essa assinatura pra confirmar que veio da Meta. - Webhook deve ser HTTPS válido (certificado público, não self-signed). - Recomendado usar header customizado de auth como camada extra.
Quem cuida: se empresa usa plataforma como CRPRO, o webhook é gerenciado pela plataforma — usuário nem precisa saber que existe. Se empresa integra Cloud API direto, precisa implementar e operar o endpoint.
Quando falha: webhook caído significa que mensagens novas não chegam, status não atualiza, automações param. Monitoramento de uptime do endpoint é crítico.