- Webhook-slutpunkter modtager
telephony.complete(telefonopkald) ellerweb.complete(webopkald og builder-mikrofontestopkald) med den stabile payload, der er dokumenteret nedenfor, etevent_idpr. levering, en timeout på 30 s og genforsøg i op til 24 t. - Den ældre webhook med én URL modtager ét synkront forsøg (timeout på 10 s, ingen genforsøg) med en lidt anderledes payload — se Forskelle i ældre payload.
Request-payload (leveringer til slutpunkter)
Slutårsager
Transkriptformat
Hvert element itranscripts er én samtaletur. Roller er
user (opkalderens tale), model (agentens tale og værktøjskald),
tool (værktøjsresultater) og system (opkaldshændelser såsom
sprogskift).
Brug den fuldt strukturerede turhistorik (med afbrydelsesmarkører,
bekræftelsesprompter og rå positioner) via
GET /v1/calls/{call_id}/history.
Forskelle i ældre payloads
Den ældre webhook-konvolut med én URL er{"type": "telephony.complete" | "web.complete", "data": {…}} uden
event_id, og dens data adskiller sig fra endpoint-payloaden:
- Turarrayet ligger under
history, ikketranscripts(samme turskema som ovenfor). - Feltsættet er den rå rapport ved opkaldets afslutning og kan indeholde yderligere interne felter ud over tabellen ovenfor — behandl ukendte felter som informative.
- Webopkald (
direction: "web") udeladerfrom_number/to_numberog tilføjerorigin_domain. - Mikrofonsamtaler til Builder-test rapporteres som
telephony.completepå den ældre sti (endpoint-systemet mapper dem tilweb.complete). - Overførselskoordinering: Når et opkald slutter i en overførsel, kaldes
den ældre webhook synkront og kan svare
{"transfer_ready": false}for at signalere, at overførselsmålet ikke er klar. Ethvert andet svar (eller ingen ældre webhook) lader overførslen fortsætte. Endpoint-leveringer konsulteres aldrig til dette.
Eksempel på handler
Almindelige anvendelsestilfælde
CRM-integration
Gem hvert opkalds transskription og optagelses-URL sammen med dine
kundeposter.
Analyse
Stream transskriptioner til en pipeline til emnemodellering, udtrækning af
CSAT-signaler eller overvågning af viderestillingsrate.
Kvalitetsgennemgang
Åbn opkald i et QA-værktøj til menneskelig gennemgang, eller kør dem gennem
din egen evalueringsmodel.
Notifikationer
Underret en menneskelig kollega ved viderestilling eller fejl.
Relateret
telephony.incoming / web.incoming
Den blokerende pendant, der kører ved opkaldets start.
Hændelseskatalog
Andre hændelsestyper, du kan abonnere på.
API til opkaldshistorik
De samme data er tilgængelige via REST til efterfyldning eller genafspilning.