mode="webhook", ThunderPhone odešle blokující
požadavek telephony.incoming / web.incoming na vaši
starší URL webhooku
a na konfigurační odpověď čeká až 10 sekund. Pomocí této
výměny můžete dynamicky zvolit výzvu, hlas a nástroje pro každý hovor —
úplný postup najdete v průvodci dynamickou konfigurací hovorů.
Odebírané koncové body webhooků také přijímají
telephony.incoming / web.incoming — pro každý příchozí hovor
a webovou relaci, bez ohledu na konfiguraci agenta — tato doručení jsou však
oznámení typu fire-and-forget s event_id, nikdy blokující.
Konfigurační výměnu popsanou na této stránce přenáší pouze starší webhook s jedinou URL.
Formáty oznámení koncových bodů najdete v
katalogu událostí.502/422). Odpovězte rychle — zatímco rozhodujete, volající slyší vyzváněcí tón.
Datová část požadavku
Pro telefonní hovory (telephony.incoming):
U relací webového widgetu (
web.incoming) identifikuje data
místo telefonních čísel stránku, do které je widget vložen:
Widgety v režimu webhook doručují tento požadavek do vlastního
webhook_url publikovatelného klíče, pokud je nastaveno; jinak použijí
URL webhooku na úrovni organizace. V obou případech je požadavek podepsán pomocí organizačního webhookového secret.Schéma odpovědi
Vraťte objekt JSON popisující konfiguraci agenta pro tento hovor.prompt a voice jsou povinné; vše ostatní je volitelné.
Neznámé klíče nejvyšší úrovně jsou tiše ignorovány — název pole
s překlepem konfiguraci neodmítne, pouze se nepoužije. Speak-order
a
max_hold_seconds zde nejsou přijímány; lze je nakonfigurovat pouze
u samotného Agenta.prompt a voice povinné, vrácení {} nebo jakékoli
odpovědi, která neprojde validací, odmítne hovor s 422 — na této cestě
neexistuje záložní statický agent (číslo ani klíč v režimu webhook nemají
přiřazeného agenta).
Příklad obslužné funkce
Odpověď s funkčními nástroji
Připojte nástroje, aby AI mohla během konverzace volat vaše API:Přehled produktových úrovní
Související
telephony.complete / web.complete
Neblokující událost ukončení hovoru.
Funkční nástroje
Úplné schéma JSON pro
tools[] a kontrakt podepsaného endpointu.Webhookové endpointy
Přihlaste k odběru více adres URL pro
telephony.incoming / web.incoming.Dynamická konfigurace hovoru
Vzory pro výzvy, nástroje a A/B testy pro jednotlivé volající.