Skip to main content
Když příchozí telefonní hovor dorazí na číslo bez přiřazeného agenta nebo když se relace webového widgetu spustí na publikovatelném klíči v režimu 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í.
Blokující výměna nemá žádnou záložní možnost: pokud váš obslužný program vrátí stav jiný než 2xx, vyprší jeho časový limit nebo vrátí konfiguraci, která neprojde ověřením, hovor bude odmítnut (telefonní hovor se nespojí; požadavek relace widgetu selže s 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.
Protože jsou 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:
Požadavky na endpoint nástroje jsou podepsané stejným tajným klíčem webhooku organizace, kterým byla podepsána tato výměna. Přesný tvar a formát podepsaného požadavku najdete v dokumentaci Funkční nástroje.

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í.