# Obtenir le lien de téléchargement d'un enregistrement

> Renvoie un nouveau lien qui télécharge l'enregistrement d'un appel, valable 60 minutes. Utilisez-le quand le recording download url reçu a expiré, ou quand…

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

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

Renvoie un nouveau lien qui télécharge l'enregistrement d'un appel, valable 60 minutes. Utilisez-le quand le `recording_download_url` reçu a expiré, ou quand vous avez besoin d'un lien à la demande. L'endpoint fonctionne sur tous les comptes, pas seulement sur les comptes créés par un partenaire.

- `{id}` est un ID d'appel (`cll-*`). Un ID au préfixe non reconnu renvoie `400 INVALID_ITEM_ID`.
- `url` télécharge le fichier de l'enregistrement sans connexion à Allo. Toute personne qui a le lien peut télécharger l'enregistrement jusqu'à `expires_at` : ne le partagez qu'avec les personnes autorisées à écouter l'appel.
- `expires_at` tombe 60 minutes après la requête. Rappelez l'endpoint pour obtenir un nouveau lien.

## Qui peut obtenir le lien

L'utilisateur de l'API key doit pouvoir écouter l'enregistrement dans Allo : le propriétaire de la ligne, un admin ou manager de l'équipe, un membre avec qui la ligne est partagée, ou le destinataire d'un partage de résumé. Tout autre utilisateur reçoit `403 RECORDING_ACCESS_DENIED`.

Allo ne crée jamais de lien de téléchargement pour un appel d'une équipe HIPAA. Ces appels renvoient `403 RECORDING_DOWNLOAD_RESTRICTED` : écoutez l'enregistrement dans l'application Allo.

## Erreurs

| Code | Signification |
|------|---------------|
| `CONVERSATION_ITEM_NOT_FOUND` | Aucun appel avec cet ID n'est visible par l'utilisateur de la clé (`404`). |
| `RECORDING_NOT_FOUND` | L'appel n'a pas d'enregistrement, ou l'ID est celui d'un SMS (`msg-*`) (`404`). Seuls les appels décrochés sur des lignes avec l'enregistrement activé en ont un. |
| `RECORDING_ACCESS_DENIED` | L'utilisateur de la clé ne peut pas écouter cet enregistrement (`403`). |
| `RECORDING_DOWNLOAD_RESTRICTED` | La ligne appartient à une équipe HIPAA (`403`). |
| `RECORDING_DOWNLOAD_UNAVAILABLE` | Le lien n'a pas pu être créé (`500`). Toujours `retryable: true` : réessayez dans quelques secondes. |
