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

Iguqula umbhalo ube yizwi elikhulunywayo (text-to-speech) ekukhipheni izwi ekhasini le-demo, nxa kuvuliwe.

I-`POST /api/global-chatbot/demo/voice-speak` iguqula umbhalo ube lilizwi elikhulunywayo, nxa umsebenzi welizwi uvuliwe kudemo. I-endpoint isetshenziswa likhasi ledemo lomphakathi njalo kayihloselwanga ukuba yi-API ye-Text-to-Speech ejwayelekileyo engasetshenziswa ngokukhululekileyo. Ukuqinisekiswa kwe-Dashboard kakudingeki, kodwa kusebenza ukuhlolwa kwe-origin okuqinileyo kwe-`https://zentor-app.de` le-`https://www.zentor-app.de`. Isicelo siqukethe umbhalo ozakhulunywa lezinketho zelizwi ezihlelwe ku-schema ebhaliweyo. I-client kumele ithumele kuphela umbhalo okumele ukhulunywe sibili engxoxweni yedemo. Okufakiweyo okungelalutho, amafomethi angalunganga kumbe umsebenzi welizwi ongavulwanga kumele kuphathwe njengamaphutha. Ukuntshintsha i-origin endaweni kumbe ukubiza kusuka ku-domain yezizwe kakudluli ukuhlolwa okwenziwa yiseva. Umsebenzi lo wenza umsindo, ngakho kawumelanga uthathwe njengomsebenzi wokufunda kuphela oyi-idempotent. Ukuthumela umbhalo ofanayo kanengi kungabangela izinqubo zokusebenza ezinengi. Isikhangiso sedemo kumele sivale inkinobho yokudlala ngesikhathi kusasetshenzwa njalo siqede kahle ukudlala okuqhubekayo ngaphambi kokuqala okutsha. Inqubo eqotho iqala ngempendulo yebhothi kudemo. Umsebenzisi uvula ukukhuluma kwelizwi, ikhasi lithumela umbhalo wempendulo ku-`voice-speak`, lithole idatha yomsindo kumbe impendulo yomsindo ebhaliweyo, liyidlale ebhrawuzeni. Nxa isicelo sehluleka ngenxa ye-origin engavunyelwanga, isikhangiso kasimelanga sibize enye insiza loba yiphi, kodwa kumele sitshengise umsebenzi welizwi njengongatholakaliyo. Amaphasiwedi, ama-token kumbe okuqukethwe okuyimfihlo akumelanga kube sesicelweni. Isiteshi sedemo singesomphakathi njalo kasihloselwanga idatha eyimfihlo yamabhizinisi. Lezimpendulo zomsindo akumelanga zigcinwe unomphela kuma-log omphakathi. I-endpoint yehlukene ngokobuchwepheshe le-SIP-Voicebot. Ezocingo zisebenza kuma-instance e-SIP ahlukanisiweyo komqashi ngamunye njalo zivulwa kuphela nguMaster Admin; i-`voice-speak` kayilawuli inombolo yocingo njalo kayiqali ucingo. Ukuze kufinyeleleke kubo bonke, idemo kumele itshengise njalo umbhalo opheleleyo eceleni komsindo. Ilizwi elikhulunywayo akumelanga libe lolwazi olungekho ngokubonakalayo. Amabhrawuza angavimbela ukudlala nxa umsebenzisi engakenzi lutho; ngakho ukuqala kumele kwenziwe ngabomu ngokucindezela. Ukumisa lokudlala kutsha kumele kwenzeke ngokulawulwa.

Ukuqinisekisa ubuwena lokuvikeleka

Kakudingeki ukuqinisekisa ubuwena

Ukuhlolwa kwe-origin kumisiwe kuqine ku-https://zentor-app.de / https://www.zentor-app.de (akulungiselelwa, kungena esikhundleni se-widget token endleleni ye-demo).

I-idempotent: Yebo

Amapharamitha

visitor_id(body, string, kuyadingeka)— Kumele kube yi-UUID evumelekileyo
text(body, string, kuyadingeka)— Umbhalo okumele uguqulelwe ezwini

Isibonelo sempendulo (response)

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

Amakhodi amaphutha

400 INVALID_VISITOR_ID — visitor_id ayikho kumbe akusiyo i-UUID evumelekileyo.
403 ORIGIN_DENIED — I-origin yesicelo kayisiyo zentor-app.de.
503 VOICE_UNAVAILABLE — Umsebenzi wezwi awutholakali okwamanje.

Ubufakazi bokuhlola okuphilayo

Amacala angaphumelelanga (400 INVALID_VISITOR_ID, 503 VOICE_UNAVAILABLE, ngayinye nge-origin header elungileyo) aqinisekiswe bukhoma. Kukhona lenguqulo ye-GET yendlela efanayo (native <audio src> streaming, ukuziphatha okufanayo). Umlingani we-demo we-widget.voice_speak.

← I-chatbot ye-demo le-SSO