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.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. Aprompt é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.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
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: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.
