> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener conversación

> Recuperar el detalle de una conversación por su ID.

# Obtener conversación

Devuelve los detalles de una conversación específica, incluyendo el resumen de handoff si aplica.

<RequestExample>
  ```http theme={null}
  GET https://app.chatnorris.ai/api/v2/conversations/{conversation_id}
  Authorization: Bearer <tu_api_key>
  ```
</RequestExample>

**Scope requerido:** `conversations:read`

***

## Path parameters

| Parámetro         | Tipo   | Descripción           |
| ----------------- | ------ | --------------------- |
| `conversation_id` | string | ID de la conversación |

***

## Respuesta

```json theme={null}
{
  "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

| Campo             | Tipo           | Descripción                                                 |
| ----------------- | -------------- | ----------------------------------------------------------- |
| `id`              | string         | ID único de la conversación                                 |
| `chatbot_id`      | string         | ID del agente                                               |
| `visitor_id`      | string         | Identificador del visitante                                 |
| `visitor_name`    | string \| null | Nombre del visitante                                        |
| `visitor_email`   | string \| null | Email del visitante                                         |
| `status`          | string         | Estado: `bot`, `handoff`, `open` o `closed`                 |
| `channel`         | string         | Canal: `web`, `whatsapp`, `instagram`, `api`                |
| `handoff_summary` | string \| null | Resumen generado por IA cuando se escala a un agente humano |
| `created_at`      | string         | Fecha de inicio (ISO 8601)                                  |
| `updated_at`      | string         | Última actividad (ISO 8601)                                 |

***

## Errores comunes

| Code        | Descripción                                                |
| ----------- | ---------------------------------------------------------- |
| `NOT_FOUND` | La conversación no existe o no pertenece a tu organización |