# Obtenir plusieurs éléments de conversation

> - Maximum 100 éléments par requête batch - Dépasser cette limite renvoie une erreur 400 avec le code BATCH TOO LARGE

`POST /v2/api/conversations/items/batch`

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

## Limites

- Maximum **100 éléments** par requête batch
- Dépasser cette limite renvoie une erreur `400` avec le code `BATCH_TOO_LARGE`

## 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`)

Les éléments qui n'existent pas sont silencieusement omis de la réponse.

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

`recording_download_url` télécharge le fichier de l'enregistrement sans connexion à Allo, pendant 48 heures. Il n'est renvoyé que sur les lignes des comptes créés par un partenaire, jamais pour un appel HIPAA. Voir [Liens vers l'enregistrement](/fr/docs/conversations/get-item#liens-vers-lenregistrement).

`attachments` liste les photos et autres fichiers d'un MMS, chacun avec un `download_url` valable 30 minutes. Voir [Fichiers joints aux MMS](/fr/docs/conversations/get-item#fichiers-joints-aux-mms).

### Paramètre extend

| Valeur | Effet |
|-------|--------|
| `transcript` | Inclure les transcriptions complètes des appels pour tous les éléments d'appel du batch |

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