Skip to main content

Listar mensajes de una conversación

Devuelve todos los mensajes de una conversación, ordenados cronológicamente (más antiguos primero).
GET https://app.chatnorris.ai/api/v2/conversations/{conversation_id}/messages
Authorization: Bearer <tu_api_key>
Scope requerido: conversations:read

Path parameters

ParámetroTipoDescripción
conversation_idstringID de la conversación

Query parameters

ParámetroTipoDescripción
pageintegerNúmero de página. Default: 1
per_pageintegerMensajes por página. Default: 25, máximo 100

Respuesta

{
  "status": "success",
  "data": {
    "messages": [
      {
        "id": "msg_001",
        "role": "user",
        "content": "¿Cuáles son los horarios de atención?",
        "created_at": "2026-06-28T14:01:00.000Z"
      },
      {
        "id": "msg_002",
        "role": "assistant",
        "content": "Nuestro horario de atención es de lunes a viernes de 9:00 a 18:00 hs.",
        "created_at": "2026-06-28T14:01:05.000Z"
      },
      {
        "id": "msg_003",
        "role": "agent",
        "content": "Hola Juan, soy María del equipo de soporte. ¿En qué más puedo ayudarte?",
        "created_at": "2026-06-28T14:20:00.000Z"
      }
    ]
  },
  "pages": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 25,
    "total": 3
  }
}

Campos de respuesta

CampoTipoDescripción
idstringID único del mensaje
rolestringQuién envió el mensaje: user (visitante), assistant (IA), agent (humano)
contentstringContenido del mensaje
created_atstringFecha y hora del mensaje (ISO 8601)

Errores comunes

CodeDescripción
NOT_FOUNDLa conversación no existe o no pertenece a tu organización