- Webhook-slutpunkter tar emot
telephony.complete(telefonsamtal) ellerweb.complete(webbsamtal och mikrofonsamtal för test i byggaren) 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 enkel-URL-webhooken tar emot ett synkront försök (tidsgräns på 10 s, inga omförsök) med en något annorlunda nyttolast — se Skillnader i äldre nyttolast.
Begäransnyttolast (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 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, intetranscripts(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ämnarfrom_number/to_numberoch lägger tillorigin_domain. - Mikrofonsamtal för Builder 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ö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.
