Leads: caixa e webhook

O Zapito deliberadamente não constrói um CRM. O trabalho de um agente de suporte é responder o que consegue e te passar o resto — então, em vez de pipelines e campos de ticket, toda transferência humana aparece como lead em dois lugares: uma caixa de entrada no app e um único webhook de saída genérico que entrega para o que você já usa (Zapier, Make, HubSpot, seu próprio endpoint).

(O velho nó de canvas Log no CRM continua sendo um pass-through e nenhuma integração de tickets está por vir — a caixa + o webhook são o design.)

A caixa de leads

Caixa de entrada no app lista as suas conversas:

Os contatos aparecem pelo nome — o nome de perfil do WhatsApp ou do Telegram — então um lead é uma pessoa, não um ID.
O filtro Precisa de um humano mostra exatamente as conversas que o agente escalou.
Abrir uma mostra a transcrição completa, para você continuar de onde o agente parou.
Marcar resolvida fecha a transferência — e reativa o bot naquela conversa, que volta a responder a próxima mensagem do cliente.

O webhook de leads de saída

Configure em Configurações → Integrações: uma URL de endpoint e um segredo de assinatura. Em cada transferência, o Zapito faz um POST com JSON assim:

{
  "event": "lead.handoff",
  "at": "2026-07-01T12:00:00.000Z",
  "reason": "escalate",
  "bot": { "id": "bot_…", "name": "Luna Café" },
  "conversation": {
    "id": "conv_…",
    "channel": "whatsapp",
    "externalId": "5511999990000",
    "contactName": "Maria",
    "status": "handoff"
  },
  "transcript": [
    { "role": "user", "content": "Posso falar com uma pessoa?", "at": "2026-07-01T11:59:41.000Z" },
    { "role": "assistant", "content": "Já vou te conectar com alguém do time.", "at": "2026-07-01T11:59:44.000Z" }
  ]
}

transcript são as últimas 10 mensagens da conversa, da mais antiga para a mais nova.
reason diz qual gatilho abriu a porta da transferência: handoff (o nó de transferência do fluxo), escalate (o modelo pediu um humano), model_error ou out_of_credits. Eventos de teste usam test.

Verificando a assinatura

Toda requisição carrega X-Zapito-Signature: sha256=<hex> — o HMAC-SHA256 do corpo bruto da requisição, com o seu segredo de assinatura como chave. Calcule o HMAC sobre os bytes exatos que você recebeu e compare; rejeite o que não bater. (X-Zapito-Event: lead.handoff também é enviado para facilitar o roteamento.)

Entrega

Uma tentativa e uma repetição após 30 segundos se o seu endpoint não devolver 2xx. O resultado da entrega (enviado / falhou / pulado) fica registrado no evento da transferência.
O webhook nunca atrasa a conversa do seu cliente — dispara depois que a mensagem de transferência já foi enviada.
Use o botão Enviar evento de teste em Settings → Integrations para enviar um payload de exemplo e conferir o seu endpoint de ponta a ponta.