- Webhook-slutpunkter tar emot
telephony.complete(telefonsamtal) ellerweb.complete(webbsamtal och testanrop från byggarens mikrofon) med den stabila nyttolast som dokumenteras nedan, ettevent_idper leverans, en tidsgräns på 30 s och omförsök i upp till 24 h. - Den äldre webhooken med en enda URL tar emot ett synkront försök (10 s tidsgräns, inga omförsök) med en något annorlunda nyttolast — se Skillnader i äldre nyttolaster.
Nyttolast för begäran (slutpunktsleveranser)
Avslutsorsaker
Transkriptformat
Varje post itranscripts ä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, intetranscripts(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ämnarfrom_number/to_numberoch lägger tillorigin_domain. - Mikrofonsamtal för Builder-test rapporteras som
telephony.completepå den äldre sökvägen (endpoint-systemet mappar dem tillweb.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.