Skip to main content
Kun saapuva puhelu saapuu numeroon, johon ei ole liitetty agenttia, tai verkkowidget-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ää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.
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 tiloilla 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.
Koska 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

Määritysvastaukset on rajoitettu kokoon 5 MiB. Jos käsittelijä palauttaa suuremman vastauksen, myös 2xx-tilakoodilla, ThunderPhone ilmoittaa, että vastaus ylitti rajan, ja hylkää puhelun tai widget-istunnon. Pidä vastaus puhelun asetuksiin tarvittavissa kentissä; isännöi suuret tiedot funktiotyökalujen tai muun palvelun takana sen sijaan, että upotat ne määritykseen.

Esimerkkikäsittelijä


Vastaus funktiotyökaluilla

Liitä työkaluja, jotta tekoäly voi kutsua rajapintojasi kesken keskustelun:
Työkalun päätepisteeseen lähetettävät pyynnöt allekirjoitetaan samalla organisaation webhook-salaisuudella, jolla tämä vaihto allekirjoitettiin. Katso tarkka rakenne ja allekirjoitetun pyynnön muoto kohdasta Funktiotyökalut.

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.