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

Datový obsah požadavku (doručení na koncový bod)

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ů (se značkami přerušení, výzvami k potvrzení a nezpracovanými pozicemi) použijte GET /v1/calls/{call_id}/history.

Rozdíly staršího payloadu

Starší webhookový obal s jedinou adresou URL je {"type": "telephony.complete" | "web.complete", "data": {…}} bez event_id a jeho data se liší od payloadu koncového bodu:
  • Pole tahů je v history, nikoli v transcripts (stejné schéma tahů jako výše).
  • Sada polí představuje nezpracovaný report o ukončení hovoru a může obsahovat další interní pole nad rámec výše uvedené tabulky — s neznámými poli zacházejte jako s informativními.
  • Webové hovory (direction: "web") vynechávají from_number / to_number a přidávají origin_domain.
  • Testovací hovory mikrofonu v Builderu se ve starší cestě hlásí jako telephony.complete (systém koncového bodu 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 žádný starší webhook) umožní pokračování přepojení. Doručení koncovému bodu se k tomuto účelu nikdy nekonzultuje.

Příklad obslužné funkce


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

Integrace CRM

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

Analytika

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

Kontrola kvality

Otevírejte hovory v nástroji QA pro lidskou kontrolu nebo je spouštějte prostřednictvím vlastního vyhodnocovacího modelu.

Oznámení

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

Související

telephony.incoming / web.incoming

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

Katalog událostí

Další typy událostí, které můžete odebírat.

API historie hovorů

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