Passer au contenu principal
GET
Get conversation item
Scope requis : CONVERSATIONS_READ

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

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.

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. 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 :
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

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

Autorisations

Authorization
string
header
requis

Paramètres de chemin

id
string
requis

Item ID (cll-* for calls, msg-* for messages)

Exemple:

"cll-abc123"

Paramètres de requête

extend
string

Comma-separated optional fields. Supported: transcript

Exemple:

"transcript"

Réponse

Conversation item

data
object