Skip to main content

​
Listar conversaciones

Devuelve todas las conversaciones de la organización, ordenadas por última actividad descendente. Se puede filtrar por estado o por agente. 
GET https://app.chatnorris.ai/api/v2/conversations
Authorization: Bearer <tu_api_key>
Scope requerido: conversations:read

​
Query parameters

ParámetroTipoDescripción
statusstringFiltrar por estado: bot, handoff, open o closed
chatbot_idstringFiltrar por agente
pageintegerNúmero de página. Default: 1
per_pageintegerResultados por página. Default: 25, máximo 100

​
Respuesta

{
  "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
  }
}

​
Campos de respuesta

CampoTipoDescripción
idstringID único de la conversación
chatbot_idstringID del agente que atendió la conversación
visitor_idstringIdentificador del visitante (generado automáticamente)
visitor_namestring | nullNombre del visitante (si fue capturado via lead form)
visitor_emailstring | nullEmail del visitante (si fue capturado)
statusstringEstado: bot (en curso), handoff (esperando agente), open (atendida), closed
channelstringCanal: web, whatsapp, instagram, api
created_atstringFecha de inicio (ISO 8601)
updated_atstringÚltima actividad (ISO 8601)