Skip to main content
Událost dokončení se aktivuje po skončení každého hovoru — příchozí telefonie, odchozí telefonie, webového hovoru nebo testovacího hovoru (relace mikrofonu v nástroji pro tvorbu). Je neblokující: odpovězte libovolným stavem 2xx. Událost se doručuje oběma cestami:

Payload požadavku (doručení koncovým bodům)

Důvody ukončení

Formát přepisu

Každá položka v transcripts představuje jeden konverzační tah. Role jsou user (řeč volajícího), model (řeč agenta a volání nástrojů), tool (výsledky nástrojů) a system (události hovoru, například změny jazyka).
Pro plně strukturovanou historii tahů (včetně značek přerušení, potvrzovacích výzev a nezpracovaných pozic) použijte GET /v1/calls/{call_id}/history.

Rozdíly staršího payloadu

Starší obálka webhooku s jedinou adresou URL má podobu {"type": "telephony.complete" | "web.complete", "data": {…}} a neobsahuje event_id; její data se liší od payloadu endpointu:
  • Pole tahů je v history, nikoli v transcripts (se stejným schématem tahů jako výše).
  • Sada polí představuje nezpracovaný report po ukončení hovoru a může obsahovat další interní pole nad rámec tabulky výše — neznámá pole považujte za informativní.
  • Webové hovory (direction: "web") neobsahují from_number / to_number a přidávají origin_domain.
  • Testovací hovory mikrofonu v Builderu jsou ve starší cestě hlášeny jako telephony.complete (systém endpointů je mapuje na web.complete).
  • Koordinace přepojení: když hovor skončí přepojením, starší webhook se volá synchronně a může vrátit {"transfer_ready": false}, aby signalizoval, že cíl přepojení není připraven. Jakákoli jiná odpověď (nebo absence staršího webhooku) umožní přepojení pokračovat. Doručení endpointů se pro tento účel nikdy nekonzultují.

Příklad obslužné rutiny


Běžné případy použití

Integrace CRM

Uložte přepis každého hovoru a URL nahrávky spolu se záznamy o zákaznících.

Analytika

Odesílejte přepisy do pipeline pro modelování témat, extrakci signálů CSAT nebo sledování míry přepojení.

Kontrola kvality

Otevřete hovory v nástroji QA pro kontrolu člověkem nebo je spusťte prostřednictvím vlastního evaluačního modelu.

Oznámení

Při přepojení nebo selhání upozorněte člena týmu.

Související

telephony.incoming / web.incoming

Blokující protějšek, který se spouští při zahájení hovoru.

Katalog událostí

Další typy událostí, k jejichž odběru se můžete přihlásit.

API historie hovorů

Stejná data jsou dostupná přes REST pro doplnění dat nebo opětovné přehrání.