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

# Obtener Conversación

> Obtén los detalles de una conversación específica

## Parámetros de Path

<ParamField path="id" type="string" required>
  UUID de la conversación
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.whaapy.com/conversations/v1/550e8400-e29b-41d4-a716-446655440000" \
    -H "Authorization: Bearer wha_xxxxx"
  ```

  ```javascript Node.js theme={null}
  const conversationId = '550e8400-e29b-41d4-a716-446655440000';
  const response = await fetch(
    `https://api.whaapy.com/conversations/v1/${conversationId}`,
    {
      headers: { 'Authorization': 'Bearer wha_xxxxx' }
    }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  conversation_id = '550e8400-e29b-41d4-a716-446655440000'
  response = requests.get(
      f'https://api.whaapy.com/conversations/v1/{conversation_id}',
      headers={'Authorization': 'Bearer wha_xxxxx'}
  )
  data = response.json()
  ```

  ```php PHP theme={null}
  $conversationId = '550e8400-e29b-41d4-a716-446655440000';
  $curl = curl_init();

  curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.whaapy.com/conversations/v1/{$conversationId}",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
      "Authorization: Bearer wha_xxxxx"
    ],
  ]);

  $response = curl_exec($curl);
  $data = json_decode($response, true);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "phoneNumber": "+5215512345678",
      "contactName": "Juan Pérez",
      "profilePictureUrl": "https://...",
      "lastMessageAt": "2026-01-29T10:30:00Z",
      "unreadCount": 2,
      "status": "active",
      "settings": {
        "aiEnabled": true,
        "aiMode": "auto",
        "aiPausedUntil": null,
        "pausedBy": null
      },
      "contact": {
        "id": "uuid",
        "phoneNumber": "+5215512345678",
        "name": "Juan Pérez",
        "email": "juan@ejemplo.com",
        "avatarUrl": null,
        "tags": ["cliente-nuevo", "vip"],
        "funnelStage": {
          "id": "uuid",
          "name": "Calificado",
          "color": "#10B981",
          "position": 2
        }
      },
      "assignedTo": {
        "agentId": "uuid",
        "agentName": "María García",
        "agentEmail": "maria@empresa.com",
        "assignedAt": "2026-01-28T12:00:00Z",
        "assignmentMethod": "manual"
      },
      "stats": {
        "totalMessages": 45,
        "unreadMessages": 2
      },
      "createdAt": "2026-01-28T08:00:00Z",
      "updatedAt": "2026-01-29T10:30:00Z"
    }
  }
  ```
</ResponseExample>

## Campos de respuesta

| Campo                    | Tipo    | Descripción                           |
| ------------------------ | ------- | ------------------------------------- |
| `id`                     | string  | UUID de la conversación               |
| `phoneNumber`            | string  | Número de WhatsApp del contacto       |
| `contactName`            | string  | Nombre del contacto                   |
| `profilePictureUrl`      | string  | URL de la foto de perfil              |
| `lastMessageAt`          | string  | Fecha del último mensaje              |
| `unreadCount`            | number  | Mensajes no leídos                    |
| `status`                 | string  | `active`, `closed`, `archived`        |
| `settings.aiEnabled`     | boolean | Si la IA está activa                  |
| `settings.aiMode`        | string  | `auto` o `manual`                     |
| `settings.aiPausedUntil` | string  | Fecha hasta la que la IA está pausada |
| `contact`                | object  | Datos completos del contacto          |
| `assignedTo`             | object  | Agente asignado (null si no hay)      |
| `stats.totalMessages`    | number  | Total de mensajes                     |
| `stats.unreadMessages`   | number  | Mensajes sin leer                     |

## Errores

<ResponseExample>
  ```json 404 Not Found theme={null}
  {
    "error": "Not found",
    "message": "Conversación no encontrada"
  }
  ```
</ResponseExample>