Listar conversaciones
Devuelve todas las conversaciones de la organización, ordenadas por última actividad descendente por defecto. Se puede filtrar por estado o por agente, y cambiar el criterio de orden.conversations:read
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
GET https://app.chatnorris.ai/api/v2/conversations
Authorization: Bearer <tu_api_key>
Obtener la lista paginada de conversaciones de tu organización.
GET https://app.chatnorris.ai/api/v2/conversations
Authorization: Bearer <tu_api_key>
GET https://app.chatnorris.ai/api/v2/conversations
Authorization: Bearer <tu_api_key>
conversations:read
| Parámetro | Tipo | Descripción |
|---|---|---|
status | string | Filtrar por estado: bot, handoff, open o closed |
chatbot_id | string | Filtrar por agente |
created_after | string | Solo conversaciones creadas después de esta fecha (ISO 8601, ej. 2026-09-01T00:00:00Z) |
order_by | string | Campo de orden: created_at o updated_at. Default: updated_at |
page | integer | Número de página. Default: 1 |
per_page | integer | Resultados por página. Default: 25, máximo 100 |
{
"status": "success",
"data": {
"conversations": [
{
"id": "conv_abc123",
"chatbot_id": "bot_xyz789",
"visitor_id": "visitor_001",
"visitor_name": "Juan Pérez",
"visitor_email": "juan@empresa.com",
"status": "closed",
"channel": "web",
"created_at": "2026-06-28T14:00:00.000Z",
"updated_at": "2026-06-28T14:35:00.000Z"
}
]
},
"pages": {
"current_page": 1,
"last_page": 10,
"per_page": 25,
"total": 240
}
}
| Campo | Tipo | Descripción |
|---|---|---|
id | string | ID único de la conversación |
chatbot_id | string | ID del agente que atendió la conversación |
visitor_id | string | Identificador del visitante (generado automáticamente) |
visitor_name | string | null | Nombre del visitante (si fue capturado via lead form) |
visitor_email | string | null | Email del visitante (si fue capturado) |
status | string | Estado: bot (en curso), handoff (esperando agente), open (atendida), closed |
channel | string | Canal: web, whatsapp, instagram, api |
created_at | string | Fecha de inicio (ISO 8601) |
updated_at | string | Última actividad (ISO 8601) |
created_after con order_by=created_at y guarda el created_at del último resultado como punto de partida de la siguiente consulta.Was this page helpful?
