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

Converte testo in voce parlata (Text-to-Speech) per l'output vocale nella pagina Demo, se attivo.

`POST /api/global-chatbot/demo/voice-speak` converte testo in voce parlata se la funzione vocale è attiva per la Demo. L'endpoint viene usato dalla pagina Demo pubblica e non è previsto come API Text-to-Speech generale liberamente utilizzabile. Non richiede autenticazione dashboard, ma applica una verifica Origin fissa per `https://zentor-app.de` e `https://www.zentor-app.de`. Il request contiene il testo da riprodurre e le opzioni vocali previste dallo schema documentato. Il client dovrebbe inviare soltanto testo che deve essere realmente letto nel dialogo Demo. Input vuoti, formati non validi o funzione vocale non attiva devono essere gestiti come errori. Modificare localmente la Origin o chiamare da un dominio estraneo non aggira il controllo lato server. L'operazione genera audio e quindi non va trattata come pura lettura idempotente. Inviare più volte lo stesso testo può attivare più elaborazioni. L'interfaccia Demo dovrebbe disattivare il pulsante output durante l'elaborazione e terminare correttamente riproduzioni in corso prima di avviarne una nuova. Un flusso realistico inizia con una risposta Bot nella Demo. L'utente attiva l'output vocale, la pagina invia il testo della risposta a `voice-speak`, riceve i dati audio o la risposta audio documentata e li riproduce nel browser. Se la richiesta fallisce per Origin non autorizzata, l'interfaccia non deve chiamare un servizio sostitutivo arbitrario ma mostrare la funzione vocale come non disponibile. Password, Token o contenuti riservati non appartengono al request. Il canale Demo è pubblico e non destinato a dati aziendali segreti. Anche le risposte audio non dovrebbero essere conservate permanentemente in log pubblici. L'endpoint è tecnicamente separato dal SIP-Voicebot. La telefonia gira in istanze SIP isolate per tenant ed è attivata esclusivamente dal Master Admin; `voice-speak` non controlla numeri telefonici e non avvia chiamate. Per l'accessibilità, la Demo dovrebbe mostrare sempre il testo completo accanto all'output audio. La voce non deve contenere informazioni assenti visivamente. I browser possono bloccare la riproduzione senza interazione utente; l'avvio dovrebbe quindi essere attivato consapevolmente con un clic. Interruzione e nuova riproduzione devono essere controllabili.

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}