Skip to main content
Un événement de complétion se déclenche après la fin de chaque appel — téléphonie entrante, téléphonie sortante, appel web ou appel de test (session micro du builder). Il est non bloquant : répondez avec n’importe quel code 2xx. L’événement est envoyé par les deux canaux suivants :

Charge utile de la requête (livraisons aux points de terminaison)

Raisons de fin

Format de transcription

Chaque entrée de transcripts 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 sous transcripts (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") omettent from_number / to_number et ajoutent origin_domain.
  • Les appels de test du microphone dans le Builder sont signalés comme telephony.complete sur 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.