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

Prevádza text na hovorenú reč (Text-to-Speech) pre hlasový výstup na demo stránke, ak je aktivovaný.

`POST /api/global-chatbot/demo/voice-speak` prevádza text na hovorenú reč, ak je hlasová funkcia pre demo aktivovaná. Koncový bod používa verejná demo stránka a nie je určený ako voľne použiteľné všeobecné rozhranie API Text-to-Speech. Autentifikácia do dashboardu nie je potrebná, platí však pevná kontrola originu pre `https://zentor-app.de` a `https://www.zentor-app.de`. Požiadavka obsahuje text, ktorý sa má vydať, a jazykové možnosti predpokladané v zdokumentovanej schéme. Klient by mal posielať len text, ktorý sa má v demo dialógu skutočne prehovoriť. Prázdne vstupy, neplatné formáty alebo neaktivovaná hlasová funkcia sa musia spracovať ako chyba. Lokálna zmena originu alebo volanie z cudzej domény kontrolu na strane servera neobíde. Operácia generuje zvuk, a preto sa nemá považovať za idempotentnú čisto čítaciu operáciu. Opakované odoslanie toho istého textu môže spustiť viacero spracovaní. Demo rozhranie by malo počas spracovania deaktivovať tlačidlo výstupu a bežiace prehrávanie riadne ukončiť pred spustením nového. Realistický priebeh začína odpoveďou bota v deme. Používateľ aktivuje hlasový výstup, stránka odošle text odpovede na `voice-speak`, dostane zvukové dáta, resp. zdokumentovanú zvukovú odpoveď, a prehrá ju v prehliadači. Ak požiadavka zlyhá pre nepovolený origin, rozhranie nesmie volať žiadnu ľubovoľnú náhradnú službu, ale má hlasovú funkciu zobraziť ako nedostupnú. Heslá, tokeny ani dôverný obsah do požiadavky nepatria. Demo kanál je verejný a nie je určený pre tajné firemné údaje. Ani zvukové odpovede by sa nemali trvalo ukladať do verejných logov. Koncový bod je technicky oddelený od SIP-Voicebotu. Telefónia beží v izolovaných SIP inštanciách pre každého tenanta a aktivuje ju výlučne Master-Admin; `voice-speak` neovláda žiadne telefónne číslo a nespúšťa žiadny telefonický hovor. Z dôvodu prístupnosti by demo malo popri zvukovom výstupe vždy zobrazovať aj úplný text. Hlasový výstup nesmie obsahovať informáciu, ktorá vizuálne chýba. Prehliadače môžu prehrávanie blokovať, kým nedôjde k interakcii používateľa; štart sa preto má vyvolať zámerne kliknutím. Zrušenie a opätovné prehratie musia byť možné kontrolovaným spôsobom.

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Funkcia reči v súčasnosti nie je dostupná."}}