- Koncové body webhooků přijímají
telephony.complete(telefonní hovory) neboweb.complete(webové hovory a testovací hovory mikrofonu v editoru) se stabilním datovým obsahem popsaným níže, identifikátoremevent_idpro každé doručení, 30sekundovým časovým limitem a opakováním až po dobu 24 h. - Starší webhook s jedinou adresou URL přijímá jeden synchronní pokus (10sekundový časový limit, bez opakování) s mírně odlišným datovým obsahem — viz Rozdíly ve starším datovém obsahu.
Datový obsah požadavku (doručení na koncový bod)
Důvody ukončení
Formát přepisu
Každá položka vtranscripts 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 vtranscripts(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_numbera 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 naweb.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í.
