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_urlest 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 : utilisezrecording_download_urlsur ces comptes.recording_download_urlté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.
Fichiers joints aux MMS
attachments liste les photos et autres fichiers envoyés avec un message, dans leur ordre d'envoi :
"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.
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 :
"extracted_data": {
"contact": {
"name": "Marie Dupont",
"company": "Vibrant Events",
"job_title": "Office manager",
"website": "vibrantevents.com",
"address": "12 rue de la Paix, Paris",
"emails": ["[email protected]"]
}
}
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.