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

Pretvara tekst u govorni jezik (Text-to-Speech) za glasovnu reprodukciju na demo stranici, ako je aktivirano.

`POST /api/global-chatbot/demo/voice-speak` pretvara tekst u govor, pod uvjetom da je funkcija govora aktivirana za demo. Krajnja točka koristi se s javne demo-stranice i nije namijenjena kao opća API usluga za pretvorbu teksta u govor koja je slobodno dostupna. Za nju nije potrebna autentifikacija putem nadzorne ploče, umjesto toga provjerava se fiksna vrijednost zaglavlja Origin za `https://zentor-app.de` i `https://www.zentor-app.de`. Zahtjev sadrži tekst koji treba izgovoriti te govorne opcije predviđene dokumentiranim shemama. Klijent treba slati samo tekst koji stvarno treba biti izgovoren u demo-dijalogu. Prazni unosi, neispravni formati ili neaktivirana funkcija govora moraju se obraditi kao pogreške. Lokalna promjena vrijednosti Origin ili poziv s tuđe domene ne zaobilazi serverinsku provjeru. Ova operacija generira audiozapis i stoga se ne smatra idempotentnom operacijom čitanja. Višestruko slanje istog teksta može pokrenuti više postupaka obrade. Demo sučelje trebalo bi onemogućiti gumb za izlaz tijekom obrade i uredno zaustaviti trenutnu reprodukciju prije pokretanja nove. Realističan tijek započinje odgovorom bota u demo-sučelju. Korisnik aktivira izlaz govora, stranica šalje tekst odgovora na `voice-speak`, prima audio podatke odnosno dokumentirani audio odgovor i reproducira ga u pregledniku. Ako zahtjev ne uspije zbog neodobrene vrijednosti Origin, sučelje ne smije pozivati bilo koju zamjensku uslugu, već treba prikazati da funkcija govora nije dostupna. Lozinke, tokeni ili povjerljivi sadržaji ne pripadaju u zahtjev. Demo-kanal je javan i nije namijenjen za povjerljive poslovne podatke. Čak ni audio odgovori ne bi trebali biti trajno pohranjeni u javnim zapisima. Krajnja točka je tehnički odvojena od SIP Voicebota. Telefonija se odvija u izoliranim SIP instancama po klijentu i aktivira se isključivo putem Master Admina; `voice-speak` ne upravlja telefonskim brojem niti pokreće telefonski poziv. Za pristupačnost, demo bi uz audioizlaz uvijek trebao prikazivati i cijeli tekst. Govorni izlaz ne smije sadržavati informacije koje nedostaju vizualno. Preglednici mogu blokirati reprodukciju dok ne dođe do interakcije korisnika; stoga bi pokretanje trebalo biti namjerno pokrenuto klikom. Prekid i ponovna reprodukcija moraju biti mogući na kontroliran način.

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Značajka govora trenutno nije dostupna."}}