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

Pretvori besedilo v govor (Text-to-Speech) za govorni izpis na predstavitveni strani, če je aktiviran.

`POST /api/global-chatbot/demo/voice-speak` pretvori besedilo v govor, če je govorna funkcija za predstavitev aktivirana. Končno točko uporablja javna predstavitvena stran in ni predvidena kot prosto uporabna splošna API za pretvorbo besedila v govor. Overjanje nadzorne plošče ni potrebno, velja pa fiksno preverjanje izvora (Origin) za `https://zentor-app.de` in `https://www.zentor-app.de`. Zahteva vsebuje besedilo za izpis in govorne možnosti, predvidene v dokumentirani shemi. Odjemalec naj pošlje le besedilo, ki naj se dejansko izgovori v predstavitvenem dialogu. Prazne vnose, neveljavne formate ali neaktivirano govorno funkcijo je treba obravnavati kot napake. Lokalna sprememba izvora ali klic iz tuje domene strežniškega preverjanja ne zaobide. Operacija ustvari zvok in je zato ne gre obravnavati kot idempotentno zgolj bralno operacijo. Večkratno pošiljanje istega besedila lahko sproži več obdelovalnih postopkov. Predstavitveni vmesnik naj med obdelavo onemogoči gumb za izpis in pred začetkom novega predvajanja pravilno ustavi tekoče predvajanje. Realističen potek se začne z odgovorom bota v predstavitvi. Uporabnik vklopi govorni izpis, stran pošlje besedilo odgovora na `voice-speak`, prejme zvočne podatke oziroma dokumentirani zvočni odgovor in ga predvaja v brskalniku. Če zahteva spodleti zaradi nedovoljenega izvora, vmesnik ne sme poklicati poljubne nadomestne storitve, temveč naj govorno funkcijo prikaže kot nedostopno. Gesel, tokenov ali zaupnih vsebin v zahtevi ne sme biti. Predstavitveni kanal je javen in ni namenjen skrivnim podatkom podjetja. Tudi zvočnih odgovorov ne bi smeli trajno shranjevati v javnih dnevnikih. Končna točka je tehnično ločena od SIP-Voicebota. Telefonija teče v izoliranih instancah SIP za posameznega najemnika in jo aktivira izključno Master Admin; `voice-speak` ne upravlja nobene telefonske številke in ne sproži telefonskega klica. Zaradi dostopnosti naj predstavitev poleg zvočnega izpisa vedno prikaže celotno besedilo. Govorni izpis ne sme vsebovati informacij, ki vizualno manjkajo. Brskalniki lahko predvajanje blokirajo, dokler ni interakcije uporabnika; zato naj se začetek zavestno sproži s klikom. Prekinitev in ponovno predvajanje morata biti mogoča na nadzorovan način.

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Funkcija govora trenutno ni na voljo."}}