POST/api/global-chatbot/demo/voice-speak

Iguqula umbhalo ube inkulumo (Text-to-Speech) ukuze kuphume izwi ekhasini ledemo, uma kunikwe amandla.

I-`POST /api/global-chatbot/demo/voice-speak` iguqula umbhalo ube yinkulumo, uma umsebenzi wezwi uvuliwe ku-demo. I-endpoint isetshenziswa yikhasi le-demo lomphakathi futhi ayihloselwe ukuba yi-API ye-Text-to-Speech ejwayelekile esebenziseka ngokukhululekile. Ukuqinisekisa ubuwena ku-dashboard akudingeki, kodwa kusebenza ukuhlolwa kwe-origin okunqunyiwe kwe-`https://zentor-app.de` ne-`https://www.zentor-app.de`. Isicelo siqukethe umbhalo okufanele ukhishwe nezinketho zolimi ezihlinzekelwe ku-schema esibhaliwe. Iklayenti kufanele lithumele kuphela umbhalo okufanele ukhulunywe ngempela engxoxweni ye-demo. Okufakwayo okungenalutho, amafomethi angavumelekile noma umsebenzi wezwi ongavuliwe kufanele kuphathwe njengamaphutha. Ukushintsha kwendawo kwe-origin noma ukubiza kusuka esizindeni esingaziwa akukugwemi ukuhlolwa kohlangothi lweseva. Umsebenzi ukhiqiza umsindo ngakho akufanele uthathwe njengomsebenzi wokufunda kuphela oyi-idempotent. Ukuthumela umbhalo ofanayo kaningi kungaqalisa ukucubungula okuningi. Indawo ye-demo kufanele ivale inkinobho yokukhipha ngesikhathi sokucubungula futhi iqede kahle ukudlala okuqhubekayo ngaphambi kokuqala okusha. Inqubo engokoqobo iqala ngempendulo ye-bot ku-demo. Umsebenzisi uvula ukukhishwa kwezwi, ikhasi lithumela umbhalo wempendulo ku-`voice-speak`, lithole idatha yomsindo noma impendulo yomsindo ebhaliwe futhi liyidlale esipheqululini. Uma isicelo sehluleka ngenxa ye-origin engavunyelwe, indawo akufanele ibize enye insizakalo engahleliwe, kodwa kufanele ibonise umsebenzi wezwi njengongatholakali. Amaphasiwedi, ama-token noma okuqukethwe okuyimfihlo akufanele kube esicelweni. Isiteshi se-demo singesomphakathi futhi asihloselwe idatha eyimfihlo yenkampani. Nezimpendulo zomsindo akufanele zigcinwe unomphela kuma-log omphakathi. I-endpoint ihlukene ngokobuchwepheshe ne-SIP-Voicebot. Ucingo lusebenza ezibonelweni ze-SIP ezihlukanisiwe nge-tenant ngayinye futhi luvulwa kuphela yi-Master Admin; i-`voice-speak` ayilawuli nombolo yocingo futhi ayiqali ucingo. Ukuze kufinyeleleke kubo bonke, i-demo kufanele ihlale ibonisa umbhalo ophelele eduze nokukhishwa komsindo. Ukukhishwa kwezwi akufanele kuqukathe imininingwane engekho ngokubonakalayo. Iziphequluli zingavimba ukudlala uma kungekho kusebenzisana komsebenzisi; ngakho ukuqala kufanele kuqaliswe ngamabomu ngokuchofoza. Ukuyeka nokudlala futhi kufanele kwenzeke ngendlela elawulwayo.

Ukuqinisekisa ubunikazi nokuvikeleka

Akudingeki ukuqinisekisa ubunikazi

Ukuhlolwa kwe-origin kumiswe ngokuqinile ku-https://zentor-app.de / https://www.zentor-app.de (akulungiselelwa, kuthatha indawo ye-Widget-Token endleleni ye-demo).

I-idempotent: Yebo

Amapharamitha

visitor_id(body, string, kuyadingeka)— Kumele kube i-UUID evumelekile
text(body, string, kuyadingeka)— Umbhalo oshintshelwa enkulumweni

Isibonelo se-response

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Umsebenzi wezwi awutholakali okwamanje."}}

Amakhodi amaphutha

400 INVALID_VISITOR_ID — visitor_id ayikho noma ayiyona UUID efanele.
403 ORIGIN_DENIED — Isicelo se-Origin asiyona i-zentor-app.de.
503 VOICE_UNAVAILABLE — Umsebenzi wezwi awutholakali okwamanje.

Ubufakazi bokuhlolwa bukhoma

Amacala angemihle (400 INVALID_VISITOR_ID, 503 VOICE_UNAVAILABLE, ngayinye nge-header ye-Origin efanele) aqinisekiswe bukhoma. Kukhona nohlobo lwe-GET lwendlela efanayo (ukusakaza kwendabuko kwe-<audio src>, ukuziphatha okufanayo). Ingxenye yedemo ye-widget.voice_speak.

← I-chatbot yedemo ne-Single-Sign-On