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

# Conversations API

> Acceder al historial de conversaciones, mensajes, evaluar respuestas y exportar datos.

La API de Conversaciones te permite acceder al historial completo de interacciones, gestionar el estado de las conversaciones y evaluar respuestas.

## Endpoints disponibles

<CardGroup cols={2}>
  <Card title="Listar conversaciones" icon="list" href="/developers/api/conversations/list">
    Obtener todas las conversaciones con filtrado y paginación.
  </Card>

  <Card title="Crear conversación" icon="plus" href="/developers/api/conversations/create">
    Crear una nueva conversación programáticamente.
  </Card>

  <Card title="Obtener mensajes" icon="messages" href="/developers/api/conversations/messages-get">
    Obtener los mensajes de una conversación específica.
  </Card>

  <Card title="Actualizar estado masivo" icon="check-double" href="/developers/api/conversations/update-status">
    Actualizar el estado de múltiples conversaciones.
  </Card>

  <Card title="Evaluar respuesta" icon="thumbs-up" href="/developers/api/conversations/eval-answer">
    Evaluar la calidad de una respuesta del agente.
  </Card>

  <Card title="Evaluar con LLM" icon="robot" href="/developers/api/conversations/evaluate">
    Ejecutar evaluación completa usando LLM-as-Judge.
  </Card>
</CardGroup>

## Resumen de endpoints

| Método | Endpoint                          | Descripción                  |
| ------ | --------------------------------- | ---------------------------- |
| GET    | `/v2/conversations`               | Listar conversaciones        |
| POST   | `/v2/conversations`               | Crear conversación           |
| GET    | `/v2/conversations/{id}/messages` | Obtener mensajes             |
| POST   | `/conversations/update-status`    | Actualizar estado masivo     |
| POST   | `/conversations/eval-answer`      | Evaluar respuesta de mensaje |
| POST   | `/conversations/{id}/evaluate`    | Evaluar conversación con LLM |

## Canales disponibles

| Canal           | Descripción                      |
| --------------- | -------------------------------- |
| `api`           | Conversaciones iniciadas via API |
| `website`       | Widget de chat en sitio web      |
| `whatsapp`      | WhatsApp Business API            |
| `instagram`     | Instagram Messaging              |
| `telegram`      | Telegram Bot                     |
| `dashboard`     | Desde el dashboard de Horneross  |
| `agent_builder` | Desde el constructor de agentes  |

## Estados de conversación

| Estado            | Descripción                                       |
| ----------------- | ------------------------------------------------- |
| `UNRESOLVED`      | Conversación activa, esperando respuesta o acción |
| `RESOLVED`        | Marcada como resuelta por el agente o usuario     |
| `HUMAN_REQUESTED` | El usuario solicitó intervención humana           |