mode="webhook", ThunderPhone nosūta bloķējošu
telephony.incoming / web.incoming pieprasījumu uz jūsu
mantotā webhook URL
un līdz 10 sekundēm gaida konfigurācijas atbildi. Izmantojiet šo
apmaiņu, lai katram zvanam dinamiski izvēlētos uzvedni, balsi un rīkus —
pilnu risinājuma modeli skatiet dinamiskās zvanu konfigurācijas ceļvedī.
Abonētie webhook galapunkti arī saņem
telephony.incoming / web.incoming — par katru ienākošo zvanu
un tīmekļa sesiju neatkarīgi no tā, vai ir konfigurēts balss aģents, —
taču šīs piegādes ir paziņojumi bez atbildes gaidīšanas ar event_id,
nevis bloķējošas. Tikai mantotais viena URL webhook nodrošina šajā
lapā aprakstīto konfigurācijas apmaiņu. Galapunktu paziņojumu formas
skatiet notikumu katalogā.502/422). Atbildiet ātri — kamēr jūs
pieņemat lēmumu, zvanītājs dzird zvana signālu.
Pieprasījuma slodze
Tālruņa zvaniem (telephony.incoming):
Tīmekļa logrīka sesijām (
web.incoming) data tālruņa numuru vietā
identificē iegulšanas lapu:
Webhook režīma logrīki nosūta šo pieprasījumu uz publicējamās atslēgas
paša
webhook_url, ja tas ir iestatīts, pretējā gadījumā izmanto
organizācijas līmeņa webhook URL. Jebkurā gadījumā tas tiek parakstīts
ar organizācijas webhook secret.Atbildes shēma
Atgrieziet JSON objektu, kas apraksta balss aģenta konfigurāciju šim zvanam.prompt un voice ir obligāti; viss pārējais nav obligāts.
Nezināmas augstākā līmeņa atslēgas tiek klusi ignorētas — laukā ar
drukas kļūdu konfigurācija netiek noraidīta, taču tas netiek piemērots. Runas
secība un
max_hold_seconds šeit netiek pieņemti; tos var konfigurēt tikai
pašam balss aģentam.prompt un voice ir obligāti, atgriežot {} vai jebkuru
atbildi, kas neiztur validāciju, zvans tiek noraidīts ar 422 — šajā
ceļā nav statiska balss aģenta atkāpšanās risinājuma (tīmekļa aizķeres režīmā
numuram vai atslēgai nav piešķirts balss aģents).
Apstrādātāja piemērs
Atbilde ar funkciju rīkiem
Pievienojiet rīkus, lai AI varētu izsaukt jūsu API sarunas laikā:Produkta līmeņu īsā atsauce
Saistītā informācija
telephony.complete / web.complete
Nebloķējošs zvana beigu notikums.
Funkciju rīki
Pilna JSON shēma
tools[] un parakstītā galapunkta līgumam.Tīmekļa aizķeru galapunkti
Abonējiet vairākus URL adresēm
telephony.incoming / web.incoming.Dinamiska zvanu konfigurācija
Modeļi uzvednēm, rīkiem un A/B testiem katram zvanītājam.