- Les points de terminaison webhook reçoivent
telephony.complete(appels téléphoniques) ouweb.complete(appels web et appels de test avec le micro du builder), avec la payload stable documentée ci-dessous, unevent_idpar livraison, un délai d’expiration de 30 s et des nouvelles tentatives pendant jusqu’à 24 h. - Le webhook à URL unique hérité reçoit une tentative synchrone unique (délai d’expiration de 10 s, sans nouvelles tentatives) avec une payload légèrement différente — voir Différences de payload héritée.
Payload de la requête (livraisons aux points de terminaison)
Raisons de fin
Format des transcriptions
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 du payload hérité
L’enveloppe webhook héritée à URL unique est{"type": "telephony.complete" | "web.complete", "data": {…}} sans
aucun event_id, et ses data diffèrent 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 micro du builder sont signalés comme
telephony.completesur le chemin hérité (le système d’endpoint les mappe versweb.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 signaler 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 d’endpoint ne sont jamais consultées à cette fin.
Gestionnaire d’exemple
Cas d’utilisation courants
Intégration CRM
Enregistrez la transcription et l’URL d’enregistrement de chaque appel avec les
dossiers de vos clients.
Analytique
Transmettez les transcriptions vers un pipeline pour la modélisation de sujets, l’extraction de signaux CSAT
ou le suivi du taux de transfert.
Revue qualité
Ouvrez les appels dans un outil d’assurance qualité pour une révision humaine, ou analysez-les avec votre
propre modèle d’évaluation.
Notifications
Alertez un coéquipier humain en cas de transfert ou d’échec.
Associé
telephony.incoming / web.incoming
L’équivalent bloquant exécuté 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 rattrapage ou la relecture.