Configure o webhook para receber mensagens, status de entrega e eventos do WhatsApp em tempo real. Sem webhook ativo, você pode enviar mensagens, mas não receber atualizações automaticamente.
Requisitos
- Credenciais WhatsApp válidas
- URL pública HTTPS
- Token de verificação (Verify Token)
HTTPS obrigatório
O Meta exige que a URL do webhook use HTTPS válido com certificado.
URL do webhook
Copie a URL exibida na plataforma para configurar no Meta Business.
1https://seu-dominio.com/api/webhook/whatsappSe você usa proxy ou CDN, garanta que as requisições cheguem ao seu servidor sem bloqueios.
Configurar no Meta Business
Acesse WhatsApp → Webhooks
No Meta for Developers
No painel do app, vá em WhatsApp → Configuration → Webhooks.
Abrir Meta for DevelopersInforme URL e Verify Token
Use o token definido na plataforma
1VERIFY_TOKEN=seu_token_seguroAssine os eventos
Mensagens, status e erros
Selecione os eventos de mensagens e status para receber atualizações completas.
Testar o webhook
Salvar configuração
O Meta valida a URL automaticamente
Envie uma mensagem de teste
Use um número de QA
Envie uma mensagem para o número conectado e verifique se ela aparece no inbox.
Sem retorno?
Verifique firewall, autenticação e logs do endpoint. O Meta exige resposta HTTP 200 em até 10 segundos.
Boas práticas
- Responda rapidamente com status 200
- Valide assinaturas e tokens
- Registre logs de erro e retentativas