Quantika API Docs
v1.0 (Public API)

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 POST para 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

EventoGatilhoAplicações Comuns
message:receivedCliente enviou uma mensagem no WhatsApp.Transbordo para sistemas externos, IA externa, alertas.
message:sentMensagem enviada por atendente ou IA do Hub.Auditoria e espelhamento em CRM legado.
contact:createdNovo contato cadastrado no Hub.Sincronização com ERP, e-mail marketing.
deal:stage_changedNegociaçã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.