# Obtenir un élément de conversation

> - Les ID d'appels commencent par cll- (ex. cll-abc123 ) - Les ID de messages commencent par msg- (ex. msg-def456 )

`GET /v2/api/conversations/items/{id}`

<Note>
**Scope requis :** `CONVERSATIONS_READ`
</Note>

## Format des ID d'éléments

- Les ID d'appels commencent par `cll-` (ex. `cll-abc123`)
- Les ID de messages commencent par `msg-` (ex. `msg-def456`)

Passer un ID avec un préfixe non reconnu renvoie une erreur `400` avec le code `INVALID_ITEM_ID`.

## Notes sur les champs

| Champ | Null quand |
|-------|-----------|
| `summary` | Éléments SMS, ou appels dont le résumé IA n'est pas encore disponible |
| `duration` | Éléments SMS (s'applique uniquement aux appels) |
| `result` | Éléments SMS (s'applique uniquement aux appels) |
| `detected_outbound_voicemail` | Appels entrants, éléments SMS, ou appels sortants sans détection |
| `voicemail_left` | Appels entrants, éléments SMS, ou appels sortants pour lesquels ce n'est pas déterminé |
| `recording_url` | Enregistrement désactivé, appel sans réponse, éléments SMS, ou comptes vendus sous la marque d'un partenaire en marque blanche |
| `recording_download_url` | Comptes qui n'ont pas été créés par un partenaire, appels d'une équipe HIPAA, appels sans enregistrement, utilisateur de la clé qui ne peut pas écouter l'enregistrement, ou éléments SMS |
| `recording_download_expires_at` | Mêmes cas que `recording_download_url` |
| `recording_duration` | Enregistrement désactivé, appel sans réponse, ou éléments SMS |
| `transcript` | Non demandé via `extend=transcript`, ou éléments SMS |
| `extracted_data` | Éléments SMS, ou appels qu'Allo n'a pas analysés (non transcrits, ou analyse en cours) |
| `data_collected` | Éléments SMS |
| `content` | Éléments d'appel (s'applique uniquement aux SMS) |
| `status` | Éléments d'appel (s'applique uniquement aux SMS) |
| `attachments` | Éléments d'appel. Un SMS sans photo ni fichier renvoie un tableau vide. |
| `page_count` | Appels, messages qui ne sont pas des fax, ou fax dont le nombre de pages n'est pas encore connu |

`duration` est la durée totale de l'appel en secondes, sonnerie incluse. `recording_duration` est la durée de conversation, celle affichée dans l'application Allo pour les appels enregistrés. Pour les appels sans enregistrement, l'application utilise `duration`.

### Liens vers l'enregistrement

Un appel peut porter deux liens vers son enregistrement :

- `recording_url` est le lien Allo vers l'enregistrement. Il ouvre une page à la marque Allo pour toute personne non connectée à Allo. Il est donc absent sur les comptes vendus sous la marque d'un partenaire en marque blanche : utilisez `recording_download_url` sur ces comptes.
- `recording_download_url` télécharge le fichier de l'enregistrement sans connexion à Allo. Il reste valable 48 heures, jusqu'à `recording_download_expires_at`. Allo ne le renvoie que sur les lignes des comptes créés par un partenaire, et seulement si l'utilisateur de la clé peut écouter l'enregistrement. Il n'est jamais renvoyé pour un appel d'une équipe HIPAA.

Pour un nouveau lien valable 60 minutes, appelez [Obtenir le lien de téléchargement d'un enregistrement](/fr/docs/conversations/get-item-recording).

### Fichiers joints aux MMS

`attachments` liste les photos et autres fichiers envoyés avec un message, dans leur ordre d'envoi :

```json
"attachments": [
  {
    "file_name": "IMG_0412.jpg",
    "content_type": "image/jpeg",
    "file_size": 245760,
    "download_url": "https://...IMG_0412.jpg?X-Amz-Expires=1800&X-Amz-Signature=...",
    "download_expires_at": "2026-11-05T14:30:00Z"
  }
]
```

`download_url` télécharge le fichier sans connexion à Allo. Il reste valable 30 minutes, jusqu'à `download_expires_at`. Enregistrez le fichier, pas le lien. Pour un nouveau lien, récupérez à nouveau l'élément : chaque réponse en signe un nouveau.

`download_url` et `download_expires_at` valent `null` pour un message d'une équipe HIPAA, ou quand Allo n'a pas pu signer le lien. Le nom, le type et la taille du fichier sont toujours renvoyés.

### Fax

Un fax est un élément de `type` `SMS` avec `message_type` `FAX`. `attachments` contient le PDF du fax, et `page_count` son nombre de pages. `page_count` vaut `null` tant que le nombre de pages n'est pas connu, par exemple juste après l'[envoi d'un fax](/fr/docs/fax/send-fax).

### Valeurs du résultat

`result` vaut `ANSWERED`, `VOICEMAIL`, `TRANSFERRED_AI`, `TRANSFERRED_EXTERNAL`, `BLOCKED`, `FAILED`, `FAILED_EXTERNAL`, `RECEIVED` ou `CLOSED`. Elles ont le même sens que dans le [webhook `call.completed`](/fr/docs/webhooks/event-catalog#valeurs-du-resultat-dappel). Gérez les valeurs inconnues sans erreur : de nouveaux résultats peuvent être ajoutés.

### Données extraites

Une fois l'appel transcrit, l'IA d'Allo lit la conversation et relève les coordonnées données par l'interlocuteur. `extracted_data` les contient :

```json
"extracted_data": {
  "contact": {
    "name": "Marie Dupont",
    "company": "Vibrant Events",
    "job_title": "Office manager",
    "website": "vibrantevents.com",
    "address": "12 rue de la Paix, Paris",
    "emails": ["marie@vibrantevents.com"]
  }
}
```

Une information que personne n'a mentionnée est une chaîne vide, ou une liste `emails` vide. Ces valeurs sont ce que l'IA a entendu : vérifiez-les avant de les écrire dans votre CRM. `extracted_data` est renseigné une fois par appel et ne change pas quand un résumé est modifié.

`data_collected` est un champ historique conservé pour compatibilité. C'est un objet vide sur les appels actuels.

### Paramètre extend

| Valeur | Effet |
|-------|--------|
| `transcript` | Inclure les transcriptions complètes des appels |

Passer une valeur non prise en charge renvoie une erreur `400` avec le code `UNSUPPORTED_EXTEND_VALUE`.
