Webhooks
Receba notificações em tempo real no seu servidor, n8n, Make ou ERP sempre que ocorrerem eventos no WhatsApp, Inbox e CRM do Quantika Hub.
Como funcionam os Webhooks
Em vez de fazer requisições repetidas para verificar novidades (polling), os Webhooks empurram os dados instantaneamente para o seu servidor assim que um evento acontece.
O Quantika Hub suporta duas modalidades de Webhook:
- Webhooks de Saída (Outgoing): O Hub dispara um
POSTpara a sua URL com o payload do evento (ex: nova mensagem recebida). - Webhooks de Entrada (Incoming): Plataformas externas (Hotmart, Kiwify, Bling, Shopify) enviam notificações de compras/leads diretamente para o Hub.
Estrutura do Payload (Saída)
Todas as requisições de saída enviadas pelo Hub seguem um padrão consistente em JSON:
{
"event": "message:received",
"organizationId": "org_abc123",
"timestamp": "2026-10-17T17:30:00.000Z",
"data": {
"messageId": "msg_98765",
"conversationId": "conv_456",
"contact": {
"id": "ct_123",
"name": "Carlos Eduardo",
"phone": "+5511999998888",
"email": "carlos@empresa.com"
},
"channel": "WHATSAPP",
"text": "Olá! Gostaria de uma cotação para o plano Enterprise.",
"direction": "INBOUND"
}
}Eventos Principais
| Evento | Gatilho | Aplicações Comuns |
|---|---|---|
| message:received | Cliente enviou uma mensagem no WhatsApp. | Transbordo para sistemas externos, IA externa, alertas. |
| message:sent | Mensagem enviada por atendente ou IA do Hub. | Auditoria e espelhamento em CRM legado. |
| contact:created | Novo contato cadastrado no Hub. | Sincronização com ERP, e-mail marketing. |
| deal:stage_changed | Negociação mudou de etapa no Kanban do CRM. | Geração de contratos, faturamento, alertas Slack. |
Requisitos de Resposta e Boas Práticas
Responda rapidamente com status 200
Seu servidor deve retornar um status HTTP 200 OK em menos de 5 segundos. Processe lógicas demoradas em segundo plano (background job ou fila).
Idempotência
Armazene o identificador do evento ou da mensagem para evitar processar a mesma mensagem duas vezes no caso de retentativas automáticas.