Skip to main content
Amikor egy bejövő telefonhívás olyan számot ér el, amelyhez nincs ügynök hozzárendelve, vagy egy webes widget-munkamenet mode="webhook" beállítású publikálható kulcson indul el, a ThunderPhone blokkoló telephony.incoming / web.incoming kérést küld az Ön régi webhook URL-jére, és legfeljebb 10 másodpercig vár egy konfigurációs válaszra. Ezzel a váltással hívásonként dinamikusan választhat promptot, hangot és eszközöket — a teljes folyamatért tekintse meg a dinamikus híváskonfigurációs útmutatót.
A feliratkozott webhook-végpontok is megkapják a telephony.incoming / web.incoming eseményeket — minden bejövő hívás és webes munkamenet esetén, függetlenül attól, hogy van-e ügynök konfigurálva —, de ezek a kézbesítések event_id azonosítót tartalmazó, nem blokkoló értesítések. Csak a régi, egyetlen URL-es webhook kezeli az ezen az oldalon ismertetett konfigurációs váltást. A végpontértesítések formátumát az eseménykatalógusban találja.
A blokkoló váltásnak nincs tartalék megoldása: ha a kezelője nem 2xx állapotkódot ad vissza, időtúllépés történik, vagy olyan konfigurációt ad vissza, amely nem felel meg az ellenőrzésnek, a hívást elutasítjuk (a telefonhívás nem kapcsolódik; a widget-munkamenet kérése 502/422 hibával meghiúsul). Válaszoljon gyorsan — a hívó kicsengést hall, amíg Ön dönt.

Kérés törzse

Telefonhívásokhoz (telephony.incoming):
Webes widget-munkameneteknél (web.incoming) a data telefonos számok helyett a beágyazó oldalt azonosítja:
A webhook módú widgetek ezt a kérést a publikálható kulcs saját webhook_url értékére küldik, ha az be van állítva, ellenkező esetben a szervezeti szintű webhook URL-re. Mindkét esetben a szervezet webhook secret értékével van aláírva.

Válaszséma

Adjon vissza egy, az ehhez a híváshoz tartozó ügynökkonfigurációt leíró JSON-objektumot. A prompt és a voice kötelező; minden más opcionális.
Az ismeretlen felső szintű kulcsok automatikusan figyelmen kívül maradnak — egy elgépelt mezőnév nem utasítja el a konfigurációt, csak nem kerül alkalmazásra. A beszédsorrend és a max_hold_seconds itt nem fogadható el; ezek csak magánál az Ügynöknél konfigurálhatók.
Mivel a prompt és a voice kötelező, a {} visszaadása vagy bármely olyan válasz, amely nem felel meg az ellenőrzésnek, 422 hibával elutasítja a hívást — ezen az útvonalon nincs statikus ügynökre való visszaesés (webhook módban egy számhoz vagy kulcshoz nincs ügynök hozzárendelve).

Válaszméret-korlát

A konfigurációs válaszok mérete legfeljebb 5 MiB lehet. Ha egy kezelő ennél nagyobb választ ad vissza, akár 2xx állapotkóddal is, a ThunderPhone jelzi, hogy a válasz túllépte a korlátot, és elutasítja a hívást vagy a widget-munkamenetet. A választ a hívás beállításához szükséges mezőkre korlátozza; a nagy méretű adatokat függvényeszközök vagy más szolgáltatás mögött tárolja ahelyett, hogy beágyazná őket a konfigurációba.

Példakezelő


Válasz függvényeszközökkel

Csatoljon eszközöket, hogy az AI a beszélgetés közben meghívhassa az API-jait:
Az eszközvégpontokra irányuló kéréseket ugyanazzal a szervezeti webhooktitokkal írjuk alá, amely ezt a cserét is aláírta. A pontos struktúrát és az aláírt kérésformátumot a Függvényeszközök oldalon találja.

Termékszintek áttekintése


Kapcsolódó

telephony.complete / web.complete

A nem blokkoló hívásbefejezési esemény.

Függvényeszközök

A tools[] teljes JSON-sémája és az aláírt végpont szerződése.

Webhook-végpontok

Több URL feliratkoztatása a telephony.incoming / web.incoming eseményekre.

Dinamikus híváskonfiguráció

Minták hívónkénti promptokhoz, eszközökhöz és A/B-tesztekhez.