mode="webhook", ThunderPhone lähettää estävän
telephony.incoming / web.incoming -pyynnön
vanhaan webhook-URL-osoitteeseesi
ja odottaa määritysvasteita enintään 10 sekuntia. Käytä tätä
vaihtoa valitaksesi dynaamisesti kehotteen, äänen ja työkalut puhelukohtaisesti —
katso kokonaisvaltainen toimintamalli
dynaamisen puhelumäärityksen oppaasta.
Tilatut webhook-päätepisteet vastaanottavat myös
telephony.incoming / web.incoming -tapahtumat — jokaisesta
saapuvasta puhelusta ja web-istunnosta, riippumatta siitä, onko agentti
määritetty — mutta nämä toimitukset ovat fire-and-forget-ilmoituksia,
joissa on event_id, eivätkä ne koskaan estä toimintaa.
Vain vanha yhden URL-osoitteen webhook sisältää tämän sivun
määritysvaihdon. Päätepisteilmoitusten muodot ovat
tapahtumaluettelossa.502/422). Vastaa nopeasti — soittaja kuulee
soittoäänen, kun teet päätöstä.
Pyynnön tietosisältö
Puheluille (telephony.incoming):
Web-widget-istunnoissa (
web.incoming) data tunnistaa
upotussivun puhelinnumeroiden sijaan:
Webhook-tilan widgetit toimittavat tämän pyynnön julkaistavan avaimen
omaan
webhook_url-osoitteeseen, kun sellainen on määritetty, ja
käyttävät muuten organisaatiotason webhook-URL-osoitetta. Kummassakin
tapauksessa pyyntö allekirjoitetaan organisaation webhook-avaimella secret.Vastausskeema
Palauta JSON-objekti, joka kuvaa agentin määrityksen tätä puhelua varten.prompt ja voice ovat pakollisia; kaikki muu on valinnaista.
Tuntemattomat ylimmän tason avaimet ohitetaan hiljaisesti — kirjoitusvirheellinen
kentän nimi ei hylkää määritystä, mutta sitä ei vain käytetä. Puhejärjestystä
ja
max_hold_seconds ei hyväksytä täällä; ne voi määrittää vain itse
Agentille.prompt ja voice ovat pakollisia, arvon {} tai minkä tahansa
validoinnin läpäisemättömän vastauksen palauttaminen hylkää puhelun tilakoodilla 422 —
tällä reitillä ei ole staattisen agentin varavaihtoehtoa (webhook-tilassa numerolle
tai avaimelle ei ole määritetty agenttia).
Esimerkkikäsittelijä
Vastaus funktiotyökaluilla
Liitä työkaluja, jotta tekoäly voi kutsua rajapintojasi kesken keskustelun:Tuotetason pikaopas
Aiheeseen liittyvää
telephony.complete / web.complete
Estämätön puhelun päättymistapahtuma.
Funktiotyökalut
Täydellinen JSON-skeema kohteelle
tools[] ja allekirjoitetun päätepisteen sopimus.Webhook-päätepisteet
Tilaa useita URL-osoitteita tapahtumille
telephony.incoming / web.incoming.Dynaaminen puhelukonfiguraatio
Mallit soittajakohtaisille kehotteille, työkaluille ja A/B-testeille.