O que são Webhooks?
Webhooks são “callbacks HTTP” - quando um evento acontece (mensagem recebida, entrega confirmada), o EnviaAI envia os dados para uma URL que você define.Setup Rápido
1. Criar o Endpoint
Express.js (Node.js)
FastAPI (Python)
2. Expor na Internet
Desenvolvimento (ngrok)
Produção
Deploy em qualquer plataforma:- Vercel:
vercel deploy - Railway:
railway up - Render: Push para GitHub
- AWS Lambda: Serverless
3. Registrar o Webhook
Via API
Via Developer Portal
- Acesse dev.enviaai.app/webhooks
- Clique em “Criar Webhook”
- Preencha a URL e selecione eventos
- Copie o secret gerado
4. Testar
Via API
Via cURL
Eventos Disponíveis
Mensagens
| Evento | Quando |
|---|---|
message.received | Nova mensagem recebida |
message.sent | Mensagem enviada ao WhatsApp |
message.delivered | Mensagem entregue ao destinatário |
message.read | Destinatário leu a mensagem |
message.failed | Falha no envio |
Instância
| Evento | Quando |
|---|---|
instance.connected | Instância conectou |
instance.disconnected | Instância desconectou |
instance.qr_updated | Novo QR Code gerado |
Payloads de Exemplo
message.received
message.received
message.delivered
message.delivered
instance.disconnected
instance.disconnected
Boas Práticas
Responda rápido
Retorne 200 em menos de 5 segundos
Processe async
Use filas para processamento pesado
Verifique assinatura
Sempre valide em produção
Seja idempotente
Use messageId para evitar duplicatas
Retry e Falhas
Se seu endpoint falhar:| Tentativa | Delay |
|---|---|
| 1 | Imediato |
| 2 | 30s |
| 3 | 2min |
| 4 | 10min |
| 5 | 1h |
| 6 | 6h |