Listar Mensajes de Conversación

Este endpoint te permite obtener el historial de mensajes de una sesión de chat o conversación particular asociada a un contacto de tu organización.

Detalles del Endpoint

• URL: /api/v1/public/contacts/{contact_id}/conversations/{conversation_id}/messages
• Método: GET
• Cabeceras obligatorias:
  • X-API-Key: Tu clave de desarrollador.
• Parámetros de ruta (Path Params):
  • contact_id (obligatorio, UUID): El identificador único del contacto.
  • conversation_id (obligatorio, UUID): El identificador único de la conversación.
• Parámetros de consulta (Query Params):
  • limit (opcional, por defecto: 100): Cantidad máxima de mensajes a retornar.
  • offset (opcional, por defecto: 0): Desplazamiento de paginación.

---

Ejemplos de Petición

cURL

curl -H "X-API-Key: kinoia_live_tu_api_key" \
  "http://localhost:9000/api/v1/public/contacts/e0e26d2e-0a56-4b92-b430-c44d18ec06bd/conversations/c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f/messages"

Node.js (Axios)

import axios from 'axios';

const response = await axios.get('http://localhost:9000/api/v1/public/contacts/e0e26d2e-0a56-4b92-b430-c44d18ec06bd/conversations/c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f/messages', {
  headers: { 'X-API-Key': 'kinoia_live_tu_api_key' }
});

console.log(response.data);

---

Respuesta Esperada (200 OK)

[
  {
    "id": "msg123-abc",
    "role": "user",
    "content": "Hola, necesito ayuda con mi plan",
    "created_at": "2026-06-22T00:58:00Z"
  },
  {
    "id": "msg124-def",
    "role": "assistant",
    "content": "¡Hola! Claro, decime qué duda tenés...",
    "created_at": "2026-06-22T00:59:00Z"
  }
]