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

Szöveget alakít át beszéddé (Text-to-Speech) a demóoldalon történő hangosításhoz, ha engedélyezve van.

A `POST /api/global-chatbot/demo/voice-speak` a szöveget beszéddé alakítja, amennyiben a beszédfunkció engedélyezve van a demóhoz. A végpontot a nyilvános demóoldal használja, és nem általánosan, szabadon használható text-to-speech API-nak készült. Dashboard-hitelesítés nem szükséges, viszont rögzített Origin-ellenőrzés érvényes a `https://zentor-app.de` és a `https://www.zentor-app.de` címekre. A Request tartalmazza a felolvasandó szöveget és a dokumentált sémában meghatározott nyelvi beállításokat. A Client csak olyan szöveget küldjön, amelyet ténylegesen a demópárbeszédben kell felolvasni. Az üres bemenetet, az érvénytelen formátumot vagy a nem engedélyezett beszédfunkciót hibaként kell kezelni. Az Origin helyi módosítása vagy egy idegen domainről indított hívás nem kerüli meg a szerveroldali ellenőrzést. A művelet hanganyagot hoz létre, ezért nem tekinthető idempotens, tisztán olvasási műveletnek. Ugyanazon szöveg többszöri elküldése több feldolgozást indíthat el. A demófelületnek a feldolgozás idejére le kell tiltania a kimeneti gombot, és egy új lejátszás indítása előtt szabályosan le kell állítania a folyamatban lévő lejátszást. Egy valószerű folyamat a bot demóban adott válaszával kezdődik. A felhasználó bekapcsolja a hangkimenetet, az oldal elküldi a válasz szövegét a `voice-speak` végpontnak, megkapja a hangadatokat, illetve a dokumentált hangválaszt, majd lejátssza azt a böngészőben. Ha a kérés nem engedélyezett Origin miatt meghiúsul, a felület nem hívhat tetszőleges helyettesítő szolgáltatást, hanem a beszédfunkciót nem elérhetőként kell megjelenítenie. Jelszavakat, tokeneket vagy bizalmas tartalmat nem szabad a Requestbe tenni. A demócsatorna nyilvános, és nem titkos vállalati adatok kezelésére szolgál. A hangválaszokat sem szabad tartósan nyilvános logokban tárolni. A végpont technikailag elkülönül a SIP-voicebottól. A telefonia tenantenként elkülönített SIP-példányokban fut, és kizárólag Master Admin aktiválhatja; a `voice-speak` nem vezérel telefonszámot és nem indít telefonhívást. Az akadálymentesség érdekében a demónak a hangkimenet mellett mindig a teljes szöveget is meg kell jelenítenie. A hangkimenet nem tartalmazhat olyan információt, amely vizuálisan hiányzik. A böngészők felhasználói interakció nélkül blokkolhatják a lejátszást, ezért az indítást tudatos kattintással kell kiváltani. A megszakításnak és az újbóli lejátszásnak ellenőrzött módon lehetségesnek kell lennie.

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"A hangfunkció jelenleg nem érhető el."}}