mode="webhook" módban indítható kulcson kezdődik, a ThunderPhone egy blokkoló telephony.incoming / web.incoming kérést küld az Ön örökölt webhook URL-jére, és legfeljebb 10 másodpercig vár egy konfigurációs válaszra. Ezzel a kommunikációval hívásonként dinamikusan kiválaszthat promptot, hangot és eszközöket — a teljes folyamathoz 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ökkonfiguráció —,
de ezek a kézbesítések event_id azonosítóval rendelkező, nem blokkoló,
fire-and-forget értesítések. Az ezen az oldalon ismertetett konfigurációs
kommunikációt csak az örökölt, egyetlen URL-es webhook továbbítja. 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ési hangot hall, amíg Ön dönt.
Kérés törzse
Telefonhívásokhoz (telephony.incoming):
Webes widgetmunkameneteknél (
web.incoming) a data telefonos számok helyett a beágyazó oldalt azonosítja:
Webhook módú widgetek ezt a kérést az indítható kulcs saját
webhook_url címére küldik, ha az be van állítva, ellenkező esetben
a szervezeti szintű webhook URL-re. Mindkét esetben a szervezeti 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 legfelső 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; csak magán az Ügynökön
konfigurálhatók.prompt és a voice kötelező, a {} vagy bármely
érvényesítési hibát okozó válasz 422 értékkel elutasítja a hívást — ezen
az útvonalon nincs statikus ügynökös tartalék megoldás (webhook módban egy
számhoz vagy kulcshoz nincs ügynök hozzárendelve).
Példakezelő
Válasz funkcióeszközökkel
Csatoljon eszközöket, hogy az AI a beszélgetés közben meghívhassa az API-jait:Termékszint-gyorstalpaló
Kapcsolódó
telephony.complete / web.complete
A hívás végét jelző, nem blokkoló esemény.
Funkcióeszkö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.