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

Konverterer tekst til talt sprog (Text-to-Speech) til taleoutput på demosiden, hvis aktiveret.

`POST /api/global-chatbot/demo/voice-speak` omdanner tekst til talt sprog, forudsat at talefunktionen er aktiveret for demoen. Endepunktet bruges af den offentlige demoside og er ikke beregnet som en frit anvendelig generel tekst-til-tale-API. Dashboard-godkendelse er ikke nødvendig, men der gælder en fast oprindelseskontrol for `https://zentor-app.de` og `https://www.zentor-app.de`. Anmodningen indeholder den tekst, der skal udgives, og de sprogindstillinger, der er fastsat i det dokumenterede skema. Klienten bør kun sende tekst, der faktisk skal tales i demo-dialogen. Tomme input, ugyldige formater eller en ikke-aktiveret sprogfunktion skal behandles som fejl. En lokal ændring af origin eller et kald fra et fremmed domæne omgår ikke serverens kontrol. Operationen genererer lyd og skal derfor ikke betragtes som en idempotent ren læseoperation. Gentagen afsendelse af samme tekst kan udløse flere behandlingsforløb. Demo-grænsefladen bør deaktivere outputknappen under behandlingen og afslutte igangværende afspilninger rent, før en ny startes. Et realistisk forløb begynder med et bot-svar i demoen. Brugeren aktiverer taleudgangen, siden sender svarteksten til `voice-speak`, modtager lyddataene henholdsvis det dokumenterede lydsvar og afspiller dem i browseren. Hvis anmodningen fejler på grund af en ikke-tilladt origin, må grænsefladen ikke kalde en vilkårlig erstatningstjeneste, men bør vise talefunktionen som ikke tilgængelig. Adgangskoder, tokens eller fortroligt indhold hører ikke til i anmodningen. Demo-kanalen er offentlig og ikke beregnet til hemmelige virksomhedsdata. Lydsvar bør heller ikke gemmes permanent i offentlige logfiler. Slutpunktet er teknisk adskilt fra SIP-voiceboten. Telefonien kører i isolerede SIP-instanser pr. lejer og aktiveres udelukkende af Master Admin; `voice-speak` styrer intet telefonnummer og starter intet telefonopkald. For tilgængelighed bør demoen altid vise den fulde tekst ud over lydafspilningen. Taleudgangen må ikke indeholde information, der visuelt mangler. browsere kan blokere afspilning, så længe der ikke er sket nogen brugerinteraktion; derfor bør starten bevidst udløses ved et klik. Afbrydelse og genafspilning skal kunne styres kontrolleret.

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprogfunktion er i øjeblikket ikke tilgængelig."}}