- Webhook-eindpunten ontvangen
telephony.complete(telefoongesprekken) ofweb.complete(webgesprekken en microfoontestgesprekken in de builder) met de hieronder beschreven stabiele payload, eenevent_idper aflevering, een time-out van 30 s en opnieuw proberen gedurende maximaal 24 h. - De verouderde webhook met één URL ontvangt één synchrone poging (time-out van 10 s, geen nieuwe pogingen) met een iets andere payload — zie Verschillen in verouderde payloads.
Requestpayload (afleveringen via eindpunten)
Redenen voor beëindiging
Transcriptindeling
Elke invoer intranscripts 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 ondertranscripts(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") latenfrom_number/to_numberweg en voegenorigin_domaintoe. - Microfoontestoproepen in Builder worden op het legacy-pad gerapporteerd als
telephony.complete(het endpointsysteem koppelt ze aanweb.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.