Skip to main content

Obtener conversación

Devuelve los detalles de una conversación específica, incluyendo el resumen de handoff si aplica.
GET https://app.chatnorris.ai/api/v2/conversations/{conversation_id}
Authorization: Bearer <tu_api_key>
Scope requerido: conversations:read

Path parameters

ParámetroTipoDescripción
conversation_idstringID de la conversación

Respuesta

{
  "status": "success",
  "data": {
    "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",
    "handoff_summary": "El cliente preguntó sobre reintegros. Indica que no recibió el dinero de su devolución del 10 de junio.",
    "created_at": "2026-06-28T14:00:00.000Z",
    "updated_at": "2026-06-28T14:35:00.000Z"
  }
}

Campos de respuesta

CampoTipoDescripción
idstringID único de la conversación
chatbot_idstringID del agente
visitor_idstringIdentificador del visitante
visitor_namestring | nullNombre del visitante
visitor_emailstring | nullEmail del visitante
statusstringEstado: bot, handoff, open o closed
channelstringCanal: web, whatsapp, instagram, api
handoff_summarystring | nullResumen generado por IA cuando se escala a un agente humano
created_atstringFecha de inicio (ISO 8601)
updated_atstringÚltima actividad (ISO 8601)

Errores comunes

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