Skip to main content
Kad ienākošais tālruņa zvans sasniedz numuru bez piesaistīta balss aģenta vai tīmekļa logrīka sesija sākas ar publicējamu atslēgu režīmā 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ā.
Bloķējošajai apmaiņai nav rezerves varianta: ja jūsu apstrādātājs atgriež ne-2xx statusu, pārsniedz noildzi vai atgriež konfigurāciju, kas neiztur validāciju, zvans tiek noraidīts (tālruņa zvans netiek savienots; logrīka sesijas pieprasījums neizdodas ar 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.
Tā kā 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ā:
Rīku galapunktu pieprasījumi tiek parakstīti ar to pašu organizācijas tīmekļa aizķeres noslēpumu, ar kuru tika parakstīta šī apmaiņa. Precīzu struktūru un parakstītā pieprasījuma formātu skatiet sadaļā Funkciju rīki.

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.