Skip to main content
En slutförandehändelse utlöses efter att varje samtal avslutas — inkommande telefoni, utgående telefoni, webbsamtal eller testsamtal (mikrofonsession i byggaren). Den är icke-blockerande: svara med valfri 2xx. Händelsen levereras via båda vägarna:

Begäransnyttolast (slutpunktsleveranser)

Avslutsorsaker

Transkriptformat

Varje post i transcripts är en samtalstur. Roller är user (uppringarens tal), model (agentens tal och verktygsanrop), tool (verktygsresultat) och system (samtalshändelser som språkbyten).
Använd GET /v1/calls/{call_id}/history för den fullständigt strukturerade turhistoriken (med avbrottsmarkörer, bekräftelsefrågor och råa positioner).

Skillnader i äldre payloads

Det äldre webhook-kuvertet med en enda URL är {"type": "telephony.complete" | "web.complete", "data": {…}} utan event_id, och dess data skiljer sig från endpoint-payloaden:
  • Turmatrisen finns under history, inte transcripts (samma tur-schema som ovan).
  • Fältuppsättningen är den råa rapporten vid samtalets slut och kan innehålla ytterligare interna fält utöver tabellen ovan — behandla okända fält som information.
  • Webbsamtal (direction: "web") utelämnar from_number / to_number och lägger till origin_domain.
  • Mikrofonsamtal för Builder rapporteras som telephony.complete på den äldre sökvägen (endpoint-systemet mappar dem till web.complete).
  • Överföringssamordning: när ett samtal avslutas med en överföring anropas den äldre webhooken synkront och kan svara {"transfer_ready": false} för att signalera att överföringens måladress inte är redo. Alla andra svar (eller ingen äldre webhook) låter överföringen fortsätta. Endpoint-leveranser konsulteras aldrig för detta.

Exempelhanterare


Vanliga användningsfall

CRM-integration

Spara varje samtals transkription och inspelnings-URL tillsammans med dina kundregister.

Analys

Strömma transkriptioner till en pipeline för ämnesmodellering, extrahering av CSAT-signaler eller övervakning av överföringsfrekvens.

Kvalitetsgranskning

Öppna samtal i ett QA-verktyg för mänsklig granskning, eller kör dem genom din egen utvärderingsmodell.

Aviseringar

Avisera en mänsklig teammedlem vid överföring eller fel.

Relaterat

telephony.incoming / web.incoming

Den blockerande motsvarigheten som körs när samtalet startar.

Händelsekatalog

Andra händelsetyper som du kan prenumerera på.

API för samtalshistorik

Samma data är tillgängliga via REST för återfyllning eller upprepning.