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

Omvandlar text till talat språk (text-to-speech) för taluppspelningen på demosidan, om den är aktiverad.

`POST /api/global-chatbot/demo/voice-speak` omvandlar text till talat språk, förutsatt att talfunktionen är aktiverad för demon. Endpointen används av den offentliga demosidan och är inte avsedd som ett fritt användbart allmänt text-till-tal-API. Ingen dashboard-autentisering krävs, men en fast origin-kontroll gäller för `https://zentor-app.de` och `https://www.zentor-app.de`. Begäran innehåller den text som ska läsas upp och de talalternativ som föreskrivs i det dokumenterade schemat. Klienten bör endast skicka text som faktiskt ska uttalas i demodialogen. Tomma inmatningar, ogiltiga format eller en talfunktion som inte är aktiverad måste hanteras som fel. En lokal ändring av origin eller ett anrop från en främmande domän kringgår inte kontrollen på serversidan. Operationen genererar ljud och ska därför inte betraktas som en idempotent, rent läsande operation. Om samma text skickas flera gånger kan flera bearbetningar utlösas. Demogränssnittet bör inaktivera uppspelningsknappen under bearbetningen och avsluta pågående uppspelningar korrekt innan en ny startas. Ett realistiskt förlopp börjar med ett botsvar i demon. Användaren aktiverar taluppspelningen, sidan skickar svarstexten till `voice-speak`, får ljuddata respektive det dokumenterade ljudsvaret och spelar upp det i webbläsaren. Om begäran misslyckas på grund av en icke tillåten origin får gränssnittet inte anropa någon godtycklig ersättningstjänst, utan bör visa talfunktionen som inte tillgänglig. Lösenord, tokens eller konfidentiellt innehåll hör inte hemma i begäran. Demokanalen är offentlig och inte avsedd för hemliga företagsdata. Inte heller ljudsvar bör lagras permanent i offentliga loggar. Endpointen är tekniskt skild från SIP-Voicebot. Telefonin körs i isolerade SIP-instanser per tenant och aktiveras uteslutande av Master Admin; `voice-speak` styr inget telefonnummer och startar inget telefonsamtal. För tillgänglighetens skull bör demon alltid visa hela texten vid sidan av ljudutmatningen. Taluppspelningen får inte innehålla någon information som saknas visuellt. Webbläsare kan blockera uppspelning så länge ingen användarinteraktion har skett; därför bör starten medvetet utlösas med ett klick. Avbrott och ny uppspelning måste kunna ske kontrollerat.

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Talfunktionen är för närvarande inte tillgänglig."}}