> For the complete documentation index, see [llms.txt](https://saludplus.gitbook.io/saludplus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://saludplus.gitbook.io/saludplus/modulos/chat-soporte/historial.md).

# Historial

Consulta del historial de conversaciones pasadas de un usuario.

### Descripción

Permite consultar el historial de conversaciones de chat de un usuario durante un período determinado.

***

### Método del Servicio

```csharp
Task<IEnumerable<ChatSoporteDTO>> ObtenerHistorial(string usuarioId, int institucionId, int diasAtras = 30)
```

### Parámetros

| Parámetro     | Tipo   | Descripción                       | Default |
| ------------- | ------ | --------------------------------- | ------- |
| usuarioId     | string | Identificador del usuario         |         |
| institucionId | int    | ID de la institución              |         |
| diasAtras     | int    | Días hacia atrás para la búsqueda | 30      |

### Flujo

1. Busca chats donde `UsuarioId == usuarioId` AND `InstitucionId == institucionId` AND `CreatedAt >= (hoy - diasAtras)`
2. Ordena por `UpdatedAt` descendente
3. Para cada chat, obtiene el primer mensaje del paciente como `primerMensaje`
4. Retorna la lista ordenada

### Ejemplo de Respuesta

```json
[
  {
    "id": "chat_id_1",
    "institucion": "IPS SaludPlus",
    "usuarioId": "user_123",
    "status": "closed",
    "primerMensaje": "Tengo una consulta sobre mi cita...",
    "createdAt": "2026-04-10T09:00:00Z",
    "updatedAt": "2026-04-10T09:45:00Z"
  }
]
```

### Uso Común

* Mostrar lista de conversaciones pasadas en la interfaz del usuario
* Permitir resumes de chats anteriores
* Historial de soporte para auditoria