Skip to main content
Kun saapuva puhelu saapuu numeroon, jolle ei ole määritetty agenttia, tai web-widget-istunto käynnistyy julkaistavalla avaimella 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.
Estävällä vaihdolla ei ole varavaihtoehtoa: jos käsittelijäsi palauttaa muun kuin 2xx-tilan, aikakatkaistaan tai palauttaa määrityksen, joka ei läpäise validointia, puhelu hylätään (puhelua ei yhdistetä; widget-istunnon pyyntö epäonnistuu koodeilla 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.
Koska 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:
Työkalujen päätepistepyynnöt allekirjoitetaan samalla organisaation webhook-salaisuudella, jolla tämä vaihto allekirjoitettiin. Katso tarkka rakenne ja allekirjoitetun pyynnön muoto kohdasta Function Tools.

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.