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 renvoie400 INVALID_ITEM_ID.urlté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_attombe 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. |