mode="webhook", ThunderPhone lähettää estävän
telephony.incoming / web.incoming -pyynnön
vanhaan webhook-URL-osoitteeseesi
ja odottaa määritysvastausta enintään 10 sekuntia. Käytä tätä
vaihtoa kehotteen, äänen ja työkalujen dynaamiseen valintaan puhelukohtaisesti —
katso kokonaisvaltainen toimintamalli dynaamisen puhelumäärityksen oppaasta.
Tilatut webhook-päätepisteet vastaanottavat myös
telephony.incoming / web.incoming -tapahtumat — jokaisesta
saapuvasta puhelusta ja verkkoistunnosta riippumatta siitä, onko agentti
määritetty — mutta nämä toimitukset ovat lähetä-ja-unohda-ilmoituksia,
joissa on event_id, eivätkä ne koskaan estä käsittelyä.
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
hälytysäänen, kun teet päätöksen.
Pyynnön hyötykuorma
Puheluissa (telephony.incoming):
Verkkowidget-istunnoissa (
web.incoming) data tunnistaa
upotussivun puhelinnumeroiden sijaan:
Webhook-tilassa olevat widgetit toimittavat tämän pyynnön julkaistavan avaimen
omaan
webhook_url-osoitteeseen, kun sellainen on määritetty, ja muussa
tapauksessa organisaatiotason webhook-URL-osoitteeseen. Molemmissa tapauksissa
pyyntö allekirjoitetaan organisaation webhook-avaimella secret.Vastausskeema
Palauta JSON-objekti, joka kuvaa agentin määrityksen tälle puhelulle.prompt ja voice vaaditaan; kaikki muu on valinnaista.
Tuntemattomat ylimmän tason avaimet ohitetaan hiljaisesti — kirjoitusvirheen sisältävä
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 voidaan
määrittää vain itse Agentissa.prompt ja voice vaaditaan, {}:n tai muun validoinnin
epäonnistuvan vastauksen palauttaminen hylkää puhelun virhekoodilla 422 —
tällä polulla ei ole staattisen agentin varavaihtoehtoa (webhook-tilassa
numerolle tai avaimelle ei ole määritetty agenttia).
Vastauksen kokoraja
Esimerkkikäsittelijä
Vastaus funktiotyökaluilla
Liitä työkaluja, jotta tekoäly voi kutsua rajapintojasi kesken keskustelun:Tuotetasoani pikaopas
Aiheeseen liittyvät
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.
