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

Gjør tekst om til tale (text-to-speech) for opplesning på demosiden, dersom aktivert.

`POST /api/global-chatbot/demo/voice-speak` gjør tekst om til tale, forutsatt at talefunksjonen er aktivert for demoen. Endepunktet brukes av den offentlige demosiden og er ikke ment som et fritt tilgjengelig, generelt text-to-speech-API. Autentisering i dashbordet kreves ikke; i stedet gjelder en fast Origin-kontroll for `https://zentor-app.de` og `https://www.zentor-app.de`. Forespørselen inneholder teksten som skal leses opp, og taleinnstillingene som er definert i det dokumenterte skjemaet. Klienten bør bare sende tekst som faktisk skal leses opp i demodialogen. Tomme inndata, ugyldige formater eller en talefunksjon som ikke er aktivert, må behandles som feil. En lokal endring av Origin eller et kall fra et fremmed domene omgår ikke kontrollen på serversiden. Operasjonen genererer lyd og er derfor ikke å regne som en idempotent, ren leseoperasjon. Gjentatt sending av samme tekst kan utløse flere behandlinger. Demogrensesnittet bør deaktivere avspillingsknappen under behandlingen og avslutte pågående avspillinger på en ryddig måte før en ny startes. Et realistisk forløp begynner med et bot-svar i demoen. Brukeren aktiverer opplesningen, siden sender svarteksten til `voice-speak`, mottar lyddataene eller det dokumenterte lydsvaret og spiller det av i nettleseren. Mislykkes forespørselen på grunn av en ikke-tillatt Origin, skal grensesnittet ikke kalle en vilkårlig erstatningstjeneste, men vise talefunksjonen som utilgjengelig. Passord, tokener eller fortrolig innhold hører ikke hjemme i forespørselen. Demokanalen er offentlig og ikke ment for hemmelige bedriftsdata. Heller ikke lydsvar bør lagres varig i offentlige logger. Endepunktet er teknisk adskilt fra SIP-voiceboten. Telefonien kjører i isolerte SIP-instanser per tenant og aktiveres utelukkende av Master-admin; `voice-speak` styrer ikke noe telefonnummer og starter ingen telefonsamtale. Av hensyn til universell utforming bør demoen alltid vise hele teksten i tillegg til lyden. Opplesningen skal ikke inneholde informasjon som mangler visuelt. Nettlesere kan blokkere avspillingen så lenge det ikke har skjedd noen brukerinteraksjon; derfor bør starten utløses bevisst med et klikk. Avbrudd og ny avspilling må kunne skje kontrollert.

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Talefunksjonen er for øyeblikket ikke tilgjengelig."}}