agent.lead

EVENTOagent.leaddesde M5benvelope v1

Lead qualificado pelo atendente.

Quando é emitido

O Atendente LiteZap (ação lead permitida, ex.: modo SDR ou vendedor) entendeu a necessidade do cliente. Leve para o CRM com um webhook ou n8n. Repetições idênticas no mesmo chat em 24h não são reemitidas. O telefone não passa pela IA: use chat.

Campos de data

Campo	Tipo	Descrição
chat	string	Chat do cliente.
message_id	string	Mensagem que disparou.
agent_id	string	Agente que atendeu.
agent_name	string	Nome do agente.
mode	string	Modo do agente.
customer_name	string	Nome informado (pode ser vazio).
need	string	Necessidade do cliente.
notes	string	Observações.

O envelope (id, type, version, instance_id, timestamp,data) está em Visão geral. Campos novos podem ser adicionados emdata sem mudar a versão: ignore os que não conhecer.

Exemplos

Corpo do POST

{
  "id": "evt_2b8d4f0a6c1e3957",
  "type": "agent.lead",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-18T19:10:00.000Z",
  "data": {
    "chat": "[email protected]",
    "message_id": "msg_1a2b3c4d5e6f7a8b",
    "agent_id": "agt_3c9e1a7f5d2b4086",
    "agent_name": "Sara",
    "mode": "sdr",
    "customer_name": "Rui",
    "need": "limpeza de pele",
    "notes": ""
  }
}

Entrega e ordem

• Por webhook: pelo menos uma vez, com retry por até 24 horas. O mesmo evento pode chegar duas vezes: deduplique porX-LiteZap-Event-Id. Veja Entrega e retentativas.
• A ordem entre eventos não é garantida (retentativas reordenam): use timestamp.
• Por SSE: ao vivo, sem replay. Veja Tempo real com SSE.
• Para assinar só este tipo: "events": ["agent.lead"] no webhook, ou?types=agent.lead no SSE.

Relacionados: agent.appointment_requested · agent.order_draft

Equivalente na Z-API: (sem equivalente).