Leads: bandeja y webhook

Zapito deliberadamente no construye un CRM. El trabajo de un agente de soporte es responder lo que puede y pasarte el resto — así que en lugar de pipelines y campos de tickets, cada traspaso a humano se muestra como lead en dos sitios: una bandeja en la app y un único webhook saliente genérico que lo entrega a lo que ya uses (Zapier, Make, HubSpot, tu propio endpoint).

(El viejo nodo de lienzo Log a CRM sigue siendo un pass-through y no llegará ninguna integración de tickets — la bandeja + el webhook son el diseño.)

La bandeja de leads

Bandeja en la app lista tus conversaciones:

Los contactos aparecen por nombre — el nombre de perfil de WhatsApp o el de Telegram — así que un lead es una persona, no un ID.
El filtro Necesita un humano muestra exactamente las conversaciones que el agente escaló.
Al abrir una ves la transcripción completa, para retomar donde el agente lo dejó.
Marcar resuelta cierra el traspaso — y reactiva el bot en esa conversación, que vuelve a responder el siguiente mensaje del cliente.

El webhook saliente de leads

Configúralo en Ajustes → Integraciones: una URL de endpoint y un secreto de firma. En cada traspaso, Zapito hace un POST con JSON como este:

{
  "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": "¿Puedo hablar con una persona?", "at": "2026-07-01T11:59:41.000Z" },
    { "role": "assistant", "content": "Te conecto con alguien del equipo ahora mismo.", "at": "2026-07-01T11:59:44.000Z" }
  ]
}

transcript son los últimos 10 mensajes de la conversación, del más antiguo al más nuevo.
reason dice qué disparador abrió la puerta del traspaso: handoff (el nodo de traspaso del flujo), escalate (el modelo pidió un humano), model_error o out_of_credits. Los eventos de prueba usan test.

Verificar la firma

Cada petición lleva X-Zapito-Signature: sha256=<hex> — el HMAC-SHA256 del cuerpo crudo de la petición, con tu secreto de firma como clave. Calcula el HMAC sobre los bytes exactos que recibiste y compara; rechaza lo que no coincida. (También se envía X-Zapito-Event: lead.handoff para enrutar fácil.)

Entrega

Un intento y un reintento a los 30 segundos si tu endpoint no devuelve 2xx. El resultado de la entrega (enviado / fallido / omitido) se registra en el evento del traspaso.
El webhook nunca retrasa la conversación de tu cliente — se dispara después de que el mensaje de traspaso ya se envió.
Usa el botón Enviar evento de prueba en Settings → Integrations para enviar un payload de muestra y comprobar tu endpoint de punta a punta.