> ## 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.

# Historique des e-mails

> Consultez les conversations e-mail de l'assistant en parallèle des appels.

Les e-mails de l'assistant apparaissent dans l'**Historique** dès que SendGrid transmet un message entrant. L'échange complet est regroupé en une seule ligne de conversation, comme pour un appel : client → assistant → client → assistant.

Chaque message conserve un `thread_id` stable pour la conversation, ainsi qu'un identifiant `in_reply_to` pointant vers son parent immédiat. Les réponses entrantes sont rattachées via les en-têtes standard `Message-ID`, `In-Reply-To` et `References`, avec en repli un jeton de fil compact intégré à l'adresse de réponse.

## Tableau de l'historique

Utilisez **Type → Email** pour n'afficher que les e-mails. Le sens indique comment la conversation a démarré : un message client entrant reste entrant même après la réponse de l'assistant, tandis qu'un e-mail sortant autonome reste sortant. La recherche porte sur les adresses e-mail, les objets et le corps des messages en texte brut ; les filtres d'assistant et de statut s'appliquent aussi bien aux appels qu'aux e-mails.

Les états de réponse des e-mails reprennent les statuts partagés de l'Historique :

| État de l'e-mail        | Statut dans l'Historique |
| ----------------------- | ------------------------ |
| Réponse en attente      | `in_progress`            |
| Réponse envoyée         | `completed`              |
| E-mail sortant          | `completed`              |
| Échec de la réponse     | `failed`                 |
| Aucun assistant assigné | `skipped`                |

Ouvrez une ligne d'e-mail pour lire, dans l'ordre chronologique, chaque message entrant et chaque réponse de l'assistant, ainsi que l'ID du fil, l'expéditeur, le destinataire, l'objet, l'assistant concerné, l'état (ou l'erreur) de la dernière réponse, et les métadonnées des pièces jointes. Le contenu des pièces jointes n'est pas conservé. La recherche couvre également chaque réponse du groupe. L'horodatage du dernier message détermine l'ordre de l'Historique : une nouvelle réponse fait donc remonter la conversation en haut de la liste.

La réponse de l'assistant est normalisée avant l'envoi. Si le modèle fait démarrer son message par `Subject:` ou `Betreff:`, cette ligne est supprimée, car SendGrid transmet déjà l'objet dans un en-tête d'e-mail distinct.

## API et MCP

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

L'endpoint de liste prend en charge `type`, `direction`, `status`, `assistant_id`, `campaign_id`, `search`, `from`, `to`, `limit` et `offset`.