Listar leads
Devuelve todos los leads capturados por los agentes de la organización, ordenados por fecha de creación descendente. Se puede filtrar por agente.GET https://app.chatnorris.ai/api/v2/leads
Authorization: Bearer <tu_api_key>
leads:read
Query parameters
| Parámetro | Tipo | Descripción |
|---|---|---|
chatbot_id | string | Filtrar leads de un agente específico |
created_after | string | Solo leads creados después de esta fecha (ISO 8601, ej. 2026-09-01T00:00:00Z) |
page | integer | Número de página. Default: 1 |
per_page | integer | Resultados por página. Default: 25, máximo 100 |
Respuesta
{
"status": "success",
"data": {
"leads": [
{
"id": "lead_abc123",
"chatbot_id": "bot_xyz789",
"conversation_id": "conv_def456",
"name": "María García",
"email": "maria@empresa.com",
"phone": "+5491112345678",
"extra_data": {
"company": "Empresa SA"
},
"channel": "whatsapp",
"contact_properties": {
"utm_source": "google"
},
"custom_fields": {
"Empresa": "Empresa SA"
},
"created_at": "2026-06-25T11:30:00.000Z"
}
]
},
"pages": {
"current_page": 1,
"last_page": 5,
"per_page": 25,
"total": 112
}
}
Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
id | string | ID único del lead |
chatbot_id | string | ID del agente que capturó el lead |
conversation_id | string | ID de la conversación asociada |
name | string | null | Nombre del lead |
email | string | null | Email del lead |
phone | string | null | Teléfono del lead |
extra_data | object | null | Datos adicionales capturados |
channel | string | null | Canal de la conversación que generó el lead: web, whatsapp, instagram, telegram, messenger o email |
contact_properties | object | Propiedades de contacto adicionales detectadas en la conversación (ej. UTMs). Objeto vacío si no hay ninguna |
custom_fields | object | Campos personalizados del lead (plan Premium). Las claves son el nombre del campo, no su ID interno — ej. { "Empresa": "Empresa SA" } |
created_at | string | Fecha de captura (ISO 8601) |
Para hacer polling incremental, usa
created_after con el created_at del último lead recibido como punto de partida de la siguiente consulta.