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

Převádí text na mluvenou řeč (text-to-speech) pro hlasový výstup na demo stránce, pokud je aktivováno.

`POST /api/global-chatbot/demo/voice-speak` převádí text na mluvenou řeč, pokud je pro demo aktivována funkce hlasu. Tento endpoint je používán veřejnou demo stránkou a není určen jako volně použitelné obecné text-to-speech API. Autentizace přes dashboard není vyžadována, místo toho platí pevná kontrola původu (origin) pro `https://zentor-app.de` a `https://www.zentor-app.de`. Požadavek obsahuje text, který má být přehrán, a jazykové možnosti stanovené v dokumentovaném schématu. Klient by měl odesílat pouze text, který má být skutečně vysloven v demo dialogu. Prázdné vstupy, neplatné formáty nebo neaktivovaná funkce hlasu musí být zpracovány jako chyby. Lokální změna původu (origin) nebo volání z cizí domény neobejde serverovou kontrolu. Operace vytváří audio, a proto ji nelze považovat za idempotentní čistě čtecí operaci. Odeslání stejného textu vícekrát může spustit více zpracování. Demo rozhraní by mělo během zpracování deaktivovat tlačítko pro výstup a čistě ukončit probíhající přehrávání před spuštěním nového. Realistický průběh začíná odpovědí bota v demu. Uživatel aktivuje hlasový výstup, stránka odešle text odpovědi na `voice-speak`, obdrží zvuková data, respektive zdokumentovanou zvukovou odpověď, a přehraje je v prohlížeči. Pokud požadavek selže kvůli nepovolené origin, rozhraní nesmí volat žádnou náhradní službu, ale mělo by zobrazit hlasovou funkci jako nedostupnou. Hesla, tokeny nebo důvěrný obsah nepatří do požadavku. Demo kanál je veřejný a není určen pro tajná firemní data. Zvukové odpovědi by také neměly být trvale ukládány do veřejných logů. Endpoint je technicky oddělen od SIP voicebota. Telefonie běží v izolovaných SIP instancích pro každého mandanta a je aktivována výhradně Master Adminem; `voice-speak` neovládá žádné telefonní číslo a nezahajuje telefonní hovor. Pro přístupnost by demo mělo vždy zobrazovat plný text vedle zvukového výstupu. Hlasový výstup nesmí obsahovat žádné informace, které vizuálně chybí. Prohlížeče mohou blokovat přehrávání, dokud nedojde k interakci uživatele; proto by měl být start vědomě spuštěn kliknutím. Přerušení a opětovné přehrávání musí být možné řízeně.

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Jazyková funkce aktuálně není k dispozici."}}