O que são Webhooks?
Webhooks permitem que você receba notificações em tempo real quando eventos acontecem na sua instância WhatsApp. Em vez de fazer polling constante na API, o EnviaAI envia os dados diretamente para seu servidor.Webhooks funcionam como “callbacks HTTP” - quando algo acontece, enviamos um POST para sua URL.
Tipos de Webhook
O EnviaAI oferece dois tipos de webhooks:Outbound (Receber Eventos)
Você configura uma URL e recebe eventos do EnviaAI.- Mensagens recebidas
- Status de entrega
- Conexão/desconexão
Inbound (Enviar Mensagens)
O EnviaAI gera uma URL única para você enviar mensagens.- Zapier, Make, n8n
- Integrações no-code
- Chamadas HTTP simples
Eventos Disponíveis
Mensagens
| Evento | Descrição |
|---|---|
message.received | Nova mensagem recebida |
message.sent | Mensagem enviada com sucesso |
message.delivered | Mensagem entregue ao destinatário |
message.read | Destinatário leu a mensagem |
message.failed | Falha no envio |
Instância
| Evento | Descrição |
|---|---|
instance.connected | Instância conectou ao WhatsApp |
instance.disconnected | Instância desconectou |
instance.qr_updated | Novo QR Code gerado |
Estrutura do Payload
Todos os webhooks seguem esta estrutura:Exemplo: Mensagem Recebida
Verificação de Assinatura
Todos os webhooks incluem uma assinatura para verificação:Política de Retry
Se seu endpoint falhar, tentamos novamente:| Tentativa | Delay |
|---|---|
| 1 | Imediato |
| 2 | 30 segundos |
| 3 | 2 minutos |
| 4 | 10 minutos |
| 5 | 1 hora |
| 6 | 6 horas |
Requisitos do Endpoint
Seu endpoint de webhook deve:Boas Práticas
Responda rápido
Retorne 200 OK imediatamente e processe em background
Seja idempotente
Use messageId para evitar processar duplicatas
Verifique assinatura
Sempre valide a assinatura em produção
Log tudo
Registre todos os eventos para debugging