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

Iguqulela umbhalo ube yintetho ekhulunyiweyo (Text-to-Speech) ukuze kubekho isandi kwiphepha le-demo, ukuba kuvuliwe.

`POST /api/global-chatbot/demo/voice-speak` iguqula umbhalo ube lilizwi elithethwayo, ukuba umsebenzi welizwi uvuliwe kwidemo. Le ndawo yokuphela isetyenziswa liphepha ledemo loluntu kwaye ayenzelwanga ukuba ibe yi-API ye-Text-to-Speech jikelele esetyenziswa ngokukhululekileyo. Akufuneki kuqinisekiswa kwe-dashboard, kodwa kusebenza ukuhlolwa kwe-Origin okumiselweyo kwe-`https://zentor-app.de` kunye ne-`https://www.zentor-app.de`. Isicelo siqulethe umbhalo ekufuneka uthethwe kunye neendlela zelizwi ezichazwe kwi-schema ebhaliweyo. Umthengi-software kufuneka athumele kuphela umbhalo ekufuneka uthethwe ngokwenene kwincoko yedemo. Okufakiweyo okungenanto, iifomathi ezingasebenziyo okanye umsebenzi welizwi ongavulwanga kufuneka kuphathwe njengeempazamo. Ukutshintsha i-Origin ekhaya okanye ukubiza kwidomeyini engaziwayo akukuphepheli ukuhlolwa kwiseva. Umsebenzi wenza i-audio kwaye ngoko akufuneki uthathwe njengomsebenzi wokufunda kuphela o-idempotent. Ukuthumela kaninzi umbhalo omnye kunokuqalisa iinkqubo ezininzi zokuqhuba. Ujongano lwedemo kufuneka luvale iqhosha lokudlala ngexesha lokuqhuba kwaye luyeke ngokucocekileyo ukudlala okuqhubekayo phambi kokuqalisa okutsha. Inkqubo yokwenyani iqala ngempendulo yebhoti kwidemo. Umsebenzisi uvula ilizwi, iphepha lithumela umbhalo wempendulo kwi-`voice-speak`, lifumane idatha ye-audio okanye impendulo ye-audio ebhaliweyo kwaye liyidlale kwibhrawuza. Ukuba isicelo siyasilela ngenxa ye-Origin engavumelekanga, ujongano akufuneki lubize nayiphi na inkonzo yendawo, kodwa kufuneka lubonise umsebenzi welizwi njengongafumanekiyo. Iiphasiwedi, ii-token okanye umxholo oyimfihlo azifanele zibe kwisicelo. Ijelo ledemo leloluntu kwaye alenzelwanga idatha eyimfihlo yenkampani. Neempendulo ze-audio akufuneki zigcinwe ngokusisigxina kwiilogi zoluntu. Le ndawo yokuphela yahlukile ngokobuchwepheshe kwi-SIP-Voicebot. Umnxeba uqhuba kwii-instance ze-SIP ezizimeleyo kwi-tenant nganye kwaye uvulwa kuphela yi-Master Admin; i-`voice-speak` ayilawuli nombolo yefowuni kwaye ayiqalisi mnxeba. Ukuze kufikeleleke kubantu abakhubazekileyo, idemo kufuneka ihlale ibonisa umbhalo opheleleyo ecaleni kwe-audio. Ilizwi akufuneki libe nolwazi olungabonakaliyo. Iibhrawuza zinokuthintela ukudlala logama kungekho sisenzo somsebenzisi; ngoko ke ukuqala kufuneka kuqaliswe ngabom ngokucofa. Ukuyeka nokudlala kwakhona kufuneka kwenzeke ngendlela elawulwayo.

Ukuqinisekiswa nokhuseleko

Akukho kuqinisekiswa kufunekayo

Ukuhlolwa kwe-Origin kubekwe ngokungaguquki ku-https://zentor-app.de / https://www.zentor-app.de (akuqwalaselwa, kuthatha indawo ye-Widget-Token kwindlela ye-demo).

Idempotent: Yebo

Iiparamitha

visitor_id(body, string, kuyafuneka)— Kufuneka ibe yi-UUID esebenzayo
text(body, string, kuyafuneka)— Umbhalo oza kuguqulelwa kwintetho

Umzekelo we-response

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Umsebenzi wentetho awukho ngoku."}}

Iikhowudi zeempazamo

400 INVALID_VISITOR_ID — visitor_id ayikho okanye ayiyiyo i-UUID esebenzayo.
403 ORIGIN_DENIED — I-Origin yesicelo ayisiyo zentor-app.de.
503 VOICE_UNAVAILABLE — Umsebenzi wentetho awukho ngoku.

Ubungqina bovavanyo oluphilayo

Iimeko ezingaphumelelanga (400 INVALID_VISITOR_ID, 503 VOICE_UNAVAILABLE, zombini ngentloko ye-Origin echanekileyo) ziqinisekisiwe ngqo. Uhlobo lwe-GET lwale ndlela nalo luyakhona (ukusasazwa kwe-<audio src>, ukuziphatha okufanayo). Ihambelana ne-demo ye-widget.voice_speak.

← I-chatbot ye-demo kunye ne-Single-Sign-On