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

Мәтінді айтылған сөзге айналдырады (мәтінді дауысқа) демо-беттегі дауыстық шығару үшін, егер қосылған болса.

`POST /api/global-chatbot/demo/voice-speak` демо үшін дауыс функциясы қосылған болса, мәтінді сөйлеу тіліне түрлендіреді. Бұл endpoint жалпыға ашық демо-бетте қолданылады және еркін пайдаланылатын жалпы Text-to-Speech API ретінде қарастырылмаған. Dashboard аутентификациясы қажет емес, бірақ `https://zentor-app.de` және `https://www.zentor-app.de` үшін бекітілген Origin тексеруі қолданылады. Request ішінде дыбысталатын мәтін және құжатталған schema-да қарастырылған тіл параметрлері болады. Client тек демо-диалогта шынымен дыбысталуы тиіс мәтінді жіберуі керек. Бос енгізу, жарамсыз формат немесе қосылмаған дауыс функциясы қате ретінде өңделуі тиіс. Origin-ді жергілікті түрде өзгерту немесе бөтен domain-нен шақыру server-side тексеруді айналып өтпейді. Бұл operation аудио жасайды, сондықтан оны idempotent таза оқу операциясы ретінде қарастыруға болмайды. Бір мәтінді бірнеше рет жіберу бірнеше өңдеу процесін іске қосуы мүмкін. Демо интерфейсі өңдеу кезінде шығару батырмасын өшіріп, жаңа ойнатуды бастамас бұрын жүріп жатқан ойнатуды дұрыс тоқтатуы керек. Нақты сценарий демода bot жауабынан басталады. Пайдаланушы дауыстық шығаруды қосады, бет жауап мәтінін `voice-speak` endpoint-іне жібереді, аудиодеректерді немесе құжатталған аудио response-ты алады да, оны браузерде ойнатады. Егер request рұқсат етілмеген Origin себебінен сәтсіз болса, интерфейс кез келген балама сервисті шақырмауы керек, керісінше дауыс функциясын қолжетімсіз деп көрсетуі тиіс. Passwords, tokens немесе құпия мазмұн Request ішіне жіберілмеуі керек. Демо-арна жалпыға ашық және құпия компания деректеріне арналмаған. Audio responses те жалпыға ашық log ішінде тұрақты сақталмауы тиіс. Бұл endpoint техникалық жағынан SIP voicebot-тан бөлек. Телефония әр tenant үшін оқшауланған SIP instance-терде жұмыс істейді және оны тек Master Admin қосады; `voice-speak` телефон нөмірін басқармайды және телефон қоңырауын бастамайды. Қолжетімділік талаптары үшін демо аудио шығарумен қатар әрқашан толық мәтінді де көрсетуі керек. Дауыстық шығаруда визуалды түрде жоқ ақпарат болмауы тиіс. Пайдаланушы әрекеті болмаса, browser ойнатуды бұғаттауы мүмкін, сондықтан іске қосу әдейі басу арқылы орындалуы керек. Тоқтату және қайта ойнату басқарылатын түрде мүмкін болуы тиіс.

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Қазіргі уақытта дауыс функциясы қолжетімсіз."}}