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 blockerar inte: svara med valfri 2xx. Händelsen levereras via båda sökvägarna:

Nyttolast för begäran (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, till exempel språkbyten).
För den fullt strukturerade turhistoriken (med avbrottsmarkörer, bekräftelseuppmaningar och råa positioner), använd GET /v1/calls/{call_id}/history.

Skillnader i äldre payload

Det äldre webhook-omslaget 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 schema för turer 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-test 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öringsmålet inte är redo. Alla andra svar (eller ingen äldre webhook) låter överföringen fortsätta. Endpoint-leveranser används aldrig för detta.

Exempelhanterare


Vanliga användningsfall

CRM-integration

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

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 manuell 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 uppspelning.