Skip to main content
Een voltooiingsgebeurtenis wordt geactiveerd nadat elk gesprek is beëindigd — inkomende telefonie, uitgaande telefonie, webgesprek of testgesprek (buildersessie met microfoon). Deze is niet-blokkerend: reageer met een willekeurige 2xx. De gebeurtenis wordt via beide paden afgeleverd:

Requestpayload (afleveringen via eindpunten)

Redenen voor beëindiging

Transcriptindeling

Elke invoer in transcripts is één gespreksbeurt. Rollen zijn user (spraak van de beller), model (spraak van de agent en toolaanroepen), tool (toolresultaten) en system (oproepgebeurtenissen zoals taalwisselingen).
Gebruik voor de volledig gestructureerde beurtgeschiedenis (met onderbrekingsmarkeringen, bevestigingsprompts en onbewerkte posities) GET /v1/calls/{call_id}/history.

Verschillen in legacy-payloads

De legacy webhook-envelop met één URL is {"type": "telephony.complete" | "web.complete", "data": {…}} zonder event_id, en de data verschilt van de endpoint-payload:
  • De beurtarray staat onder history, niet onder transcripts (hetzelfde beurtenschema als hierboven).
  • De veldenset is het onbewerkte rapport aan het einde van de oproep en kan aanvullende interne velden bevatten naast de bovenstaande tabel — behandel onbekende velden als informatief.
  • Weboproepen (direction: "web") laten from_number / to_number weg en voegen origin_domain toe.
  • Microfoontestoproepen in Builder worden op het legacy-pad gerapporteerd als telephony.complete (het endpointsysteem koppelt ze aan web.complete).
  • Overdrachtscoördinatie: wanneer een oproep eindigt in een overdracht, wordt de legacy webhook synchroon aangeroepen en kan deze {"transfer_ready": false} retourneren om aan te geven dat het overdrachtsdoel nog niet klaar is. Elke andere respons (of geen legacy webhook) laat de overdracht doorgaan. Endpoint-leveringen worden hiervoor nooit geraadpleegd.

Voorbeeldhandler


Veelvoorkomende toepassingen

CRM-integratie

Sla het transcript en de opname-URL van elke oproep op naast je klantgegevens.

Analyse

Stream transcripties naar een pipeline voor onderwerpmodellering, extractie van CSAT-signalen of monitoring van het doorverbindingspercentage.

Kwaliteitsbeoordeling

Open oproepen in een QA-tool voor menselijke beoordeling, of voer ze uit via je eigen evaluatiemodel.

Meldingen

Activeer een menselijke teamgenoot bij doorverbinding / storing.

Gerelateerd

telephony.incoming / web.incoming

De blokkerende tegenhanger die bij de start van een oproep wordt uitgevoerd.

Gebeurteniscatalogus

Andere gebeurtenistypen waarop je je kunt abonneren.

API voor oproepgeschiedenis

Dezelfde gegevens zijn via REST beschikbaar voor aanvullen / opnieuw afspelen.