- Koncové body webhooků přijímají
telephony.complete(telefonní hovory) neboweb.complete(webové hovory a testovací hovory mikrofonu v nástroji pro tvorbu) se stabilním payloadem popsaným níže, identifikátoremevent_idpro každé doručení, časovým limitem 30 s a opakovanými pokusy až po dobu 24 h. - Starší webhook s jednou adresou URL přijímá jeden synchronní pokus (časový limit 10 s, bez opakovaných pokusů) s mírně odlišným payloadem — viz Rozdíly staršího payloadu.
Payload požadavku (doručení koncovým bodům)
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ů (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 vtranscripts(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_numbera přidávajíorigin_domain. - Testovací hovory mikrofonu v Builderu jsou ve starší cestě hlášeny jako
telephony.complete(systém endpointů 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 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í.