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

# Vue d'ensemble

> Historique unifié des appels et SMS avec recherche par mots-clés et filtrage avancé

L'API Conversations fournit une vue unifiée de tous les appels et messages SMS, regroupés par numéro de téléphone du contact. Une "conversation" représente l'historique complet des interactions entre votre(vos) numéro(s) Allo et un numéro de téléphone externe.

## Concepts clés

**Conversation** — un résumé des interactions avec un `contact_number`, incluant les contacts associés et la dernière interaction (dernier appel, dernier SMS). Utilisez les endpoints `/items` pour accéder à l'historique complet.

**Élément de conversation** — un appel ou un message SMS individuel. Utilisez les endpoints de recherche ou de récupération pour obtenir les détails complets d'un élément, y compris les transcriptions, les résumés et les enregistrements.

**Association de contacts** — chaque conversation inclut les contacts associés avec leurs informations d'entreprise et de deal. Un numéro de téléphone peut correspondre à zéro, un ou plusieurs contacts.

**Recherche par mots-clés** — les endpoints de recherche prennent en charge la recherche par mots-clés dans les transcriptions d'appels, les résumés et le contenu des SMS. Utilisez `sort=RELEVANCE` pour trier les résultats par pertinence.

**Extend** — utilisez `?extend=transcript` pour inclure les transcriptions complètes des appels sur les éléments. Les transcriptions sont exclues par défaut pour garder les réponses légères.

## Endpoints

<CardGroup cols={1}>
  <Card title="Lister les conversations" href="/fr/v2/api-reference/conversations/list-conversations">
    Résumés des conversations avec la dernière interaction par numéro de contact
  </Card>

  <Card title="Obtenir un élément de conversation" href="/fr/v2/api-reference/conversations/get-item">
    Détail complet d'un appel ou SMS individuel
  </Card>

  <Card title="Rechercher des éléments de conversation" href="/fr/v2/api-reference/conversations/search-conversation-items">
    Rechercher des appels et SMS dans toutes les conversations
  </Card>

  <Card title="Obtenir plusieurs éléments de conversation" href="/fr/v2/api-reference/conversations/batch-get">
    Récupérer plusieurs éléments par ID en une seule requête
  </Card>

  <Card title="Exécuter une action de conversation" href="/fr/v2/api-reference/conversations/execute-action">
    Marquer comme lu, non lu, archiver ou désarchiver une conversation
  </Card>
</CardGroup>