- Webhook-endepunkter mottar
telephony.complete(telefonsamtaler) ellerweb.complete(nettsamtaler og mikrofontestsamtaler i byggeren) med den stabile nyttelasten som er dokumentert nedenfor, enevent_idper levering, en tidsavbruddsgrense på 30 s og nye forsøk i opptil 24 t. - Den eldre webhooken med én URL mottar ett synkront forsøk (10 s tidsavbruddsgrense, ingen nye forsøk) med en litt annerledes nyttelast — se Forskjeller i eldre nyttelast.
Nyttelast for forespørsel (leveringer til endepunkter)
Avslutningsårsaker
Transkripsjonsformat
Hver oppføring itranscripts er én samtaledreining. Rollene er
user (innringerens tale), model (agentens tale og verktøykall),
tool (verktøyresultater) og system (anropshendelser som
språkbytter).
For den fullstendig strukturerte dreiningshistorikken (med avbruddsmarkører,
bekreftelsesforespørsler og rå posisjoner), bruk
GET /v1/calls/{call_id}/history.
Forskjeller i eldre payload
Den eldre webhook-innpakningen med én URL er{"type": "telephony.complete" | "web.complete", "data": {…}} uten
event_id, og data-innholdet skiller seg fra endepunktets payload:
- Dreiningsarrayen ligger under
history, ikketranscripts(samme dreiningsskjema som ovenfor). - Feltsettet er den rå rapporten ved samtaleslutt og kan inneholde ytterligere interne felt utover tabellen ovenfor — behandle ukjente felt som informasjon.
- Nettsamtaler (
direction: "web") utelaterfrom_number/to_numberog legger tilorigin_domain. - Builder-mikrofontestsamtaler rapporteres som
telephony.completepå den eldre banen (endepunktssystemet tilordner dem tilweb.complete). - Overføringskoordinering: Når et anrop avsluttes med en overføring, kalles
den eldre webhooken synkront og kan svare
{"transfer_ready": false}for å signalisere at overføringsmålet ikke er klart. Ethvert annet svar (eller ingen eldre webhook) lar overføringen fortsette. Endepunktleveringer konsulteres aldri for dette.
Eksempelbehandler
Vanlige bruksområder
CRM-integrasjon
Lagre transkripsjonen og opptaks-URL-en for hvert anrop sammen med
kundepostene dine.
Analyse
Strøm transkripsjoner til en pipeline for emnemodellering, uthenting av
CSAT-signaler eller overvåking av overføringsrate.
Kvalitetsgjennomgang
Åpne anrop i et QA-verktøy for menneskelig gjennomgang, eller kjør dem gjennom
din egen evalueringsmodell.
Varsler
Varsle et menneskelig teammedlem ved overføring / feil.
Relatert
telephony.incoming / web.incoming
Den blokkerende motparten som kjører når anropet starter.
Hendelseskatalog
Andre hendelsestyper du kan abonnere på.
API for anropshistorikk
De samme dataene er tilgjengelige via REST for etterfylling / avspilling.