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 widgetmunkamenet 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.
A blokkoló kommunikációhoz nincs tartalék megoldás: ha a kezelője nem 2xx állapotot ad vissza, időtúllépés történik, vagy olyan konfigurációt ad vissza, amely nem felel meg az érvényesítésnek, a hívást elutasítjuk (a telefonhívás nem kapcsolódik; a widgetmunkamenet kérése 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. A prompt é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.
Mivel a 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:
Az eszközvégpont-kéréseket ugyanazzal a szervezeti webhooktitokkal írják alá, amely ezt a váltást is aláírta. A pontos struktúrát és az aláírt kérés formátumát a Funkcióeszközök oldalon találja.

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.