- Les points de terminaison de webhook reçoivent
telephony.complete(appels téléphoniques) ouweb.complete(appels web et appels de test au micro du builder) avec la charge utile stable documentée ci-dessous, unevent_idpar livraison, un délai d’expiration de 30 s et des tentatives pendant jusqu’à 24 h. - Le webhook historique à URL unique reçoit une tentative synchrone unique (délai d’expiration de 10 s, sans nouvelle tentative) avec une charge utile légèrement différente — consultez Différences de charge utile historique.
Charge utile de la requête (livraisons aux points de terminaison)
Raisons de fin
Format de transcription
Chaque entrée detranscripts correspond à un tour de conversation. Les rôles sont
user (parole de l’appelant), model (parole de l’agent et appels d’outils),
tool (résultats d’outils) et system (événements d’appel tels que les changements
de langue).
Pour l’historique complet et structuré des tours (avec les marqueurs
d’interruption, les prompts d’acquiescement et les positions brutes), utilisez
GET /v1/calls/{call_id}/history.
Différences de payload héritées
L’enveloppe webhook héritée à URL unique est{"type": "telephony.complete" | "web.complete", "data": {…}} sans
event_id, et son data diffère du payload de l’endpoint :
- Le tableau des tours se trouve sous
history, et non soustranscripts(même schéma de tour que ci-dessus). - L’ensemble de champs correspond au rapport brut de fin d’appel et peut inclure des champs internes supplémentaires au-delà du tableau ci-dessus — considérez les champs inconnus comme informatifs.
- Les appels web (
direction: "web") omettentfrom_number/to_numberet ajoutentorigin_domain. - Les appels de test du microphone dans le Builder sont signalés comme
telephony.completesur le chemin hérité (le système de l’endpoint les associe àweb.complete). - Coordination du transfert : lorsqu’un appel se termine par un transfert, le
webhook hérité est appelé de manière synchrone et peut répondre
{"transfer_ready": false}pour indiquer que la cible du transfert n’est pas prête. Toute autre réponse (ou l’absence de webhook hérité) permet au transfert de se poursuivre. Les livraisons par endpoint ne sont jamais consultées à cette fin.
Exemple de gestionnaire
Cas d’utilisation courants
Intégration CRM
Enregistrez la transcription et l’URL d’enregistrement de chaque appel avec les
données de vos clients.
Analytique
Transmettez les transcriptions à un pipeline pour la modélisation des sujets, l’extraction de signaux CSAT
ou le suivi du taux de transfert.
Contrôle qualité
Ouvrez les appels dans un outil d’assurance qualité pour une révision humaine, ou exécutez-les dans votre
propre modèle d’évaluation.
Notifications
Alertez un membre de l’équipe humaine lors d’un transfert ou d’un échec.
Associé
telephony.incoming / web.incoming
L’équivalent bloquant qui s’exécute au début de l’appel.
Catalogue des événements
Autres types d’événements auxquels vous pouvez vous abonner.
API d'historique des appels
Les mêmes données sont accessibles via REST pour le remplissage ou la relecture.
