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

# Historial de correo electrónico

> Revisa las conversaciones de correo electrónico del asistente junto con las llamadas.

Los correos electrónicos del asistente aparecen en el **Historial** en cuanto SendGrid entrega un mensaje entrante. El intercambio completo se agrupa en una sola fila de conversación, igual que una llamada: cliente → asistente → cliente → asistente.

Cada mensaje guarda un `thread_id` estable para la conversación y un ID `in_reply_to` que apunta a su mensaje padre inmediato. Las respuestas entrantes se emparejan mediante los encabezados estándar `Message-ID`, `In-Reply-To` y `References`, con un token de hilo compacto en la dirección de respuesta como respaldo.

## Tabla del historial

Usa **Tipo → Correo electrónico** para mostrar solo los correos. La dirección describe cómo empezó la conversación: un mensaje entrante de un cliente sigue siendo entrante aunque el asistente responda, mientras que un correo saliente independiente es saliente. La búsqueda encuentra coincidencias en direcciones de correo, asuntos y cuerpos en texto plano; los filtros de asistente y estado funcionan tanto en llamadas como en correos electrónicos.

Los estados de respuesta de correo electrónico usan los mismos estados compartidos del Historial:

| Estado del correo      | Estado del historial |
| ---------------------- | -------------------- |
| Respuesta pendiente    | `in_progress`        |
| Respuesta enviada      | `completed`          |
| Correo saliente        | `completed`          |
| Respuesta fallida      | `failed`             |
| Sin asistente asignado | `skipped`            |

Abre una fila de correo para leer, en orden cronológico, cada mensaje entrante y cada respuesta del asistente, junto con el ID del hilo, remitente, destinatario, asunto, asistente, el estado/error de la última respuesta y los metadatos de los adjuntos. El contenido de los adjuntos no se conserva. La búsqueda también encuentra coincidencias en cada respuesta agrupada. La hora del último mensaje determina el orden del Historial, así que una respuesta nueva vuelve a colocar la conversación en la parte superior.

La salida del asistente se normaliza antes de enviarla. Si el modelo empieza el cuerpo por accidente con `Subject:` o `Betreff:`, esa línea se elimina, porque SendGrid ya envía el asunto como un encabezado de correo independiente.

## API y MCP

* REST: `GET /api/v1/history` y `GET /api/v1/history/emails/{id}` (`calls:read`)
* MCP: `list_history` y `get_email_history_item`

El endpoint de listado admite `type`, `direction`, `status`, `assistant_id`, `campaign_id`, `search`, `from`, `to`, `limit` y `offset`.