Skip to main content
Un événement de fin est déclenché après 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 :

Payload de la requête (livraisons aux points de terminaison)

Raisons de fin

Format des transcriptions

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 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 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 micro du builder sont signalés comme telephony.complete sur le chemin hérité (le système d’endpoint les mappe vers 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 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.