Listar Conversaciones

Este endpoint te permite consultar el listado completo de conversaciones o sesiones de chat que ha mantenido un contacto específico.

Detalles del Endpoint

• URL: /api/v1/public/contacts/{contact_id}/conversations
• 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.
• Parámetros de consulta (Query Params):
  • limit (opcional, por defecto: 20): Cantidad máxima de conversaciones 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"

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', {
  headers: { 'X-API-Key': 'kinoia_live_tu_api_key' }
});

console.log(response.data);

---

Respuesta Esperada (200 OK)

[
  {
    "id": "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
    "bot_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
    "contact_id": "e0e26d2e-0a56-4b92-b430-c44d18ec06bd",
    "title": "Chat con Juan Perez",
    "status": "active",
    "channel_type": "web",
    "created_at": "2026-06-22T00:00:00Z",
    "updated_at": "2026-06-22T01:00:00Z"
  }
]