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

Konvertéiert Text an Sprooch (Text-to-Speech) fir d'Sproochsausgabe op der Demo Säit, wann aktiviert.

`POST /api/global-chatbot/demo/voice-speak` wandelt Text a gesproochene Sprooch ëm, soweit d'Sproochfunktioun fir d'Demo aktivéiert ass. Den Endpunkt gëtt vun der ëffentlecher Demo-Säit benotzt an ass net als fräi notzbar allgemeng Text-to-Speech-API geduecht. Eng Dashboard-Authentifizéierung ass net néideg, dofir gëllt eng fest Origin-Préiwung fir `https://zentor-app.de` an `https://www.zentor-app.de`. Den Request enthält den auszeginn Text an déi am dokumentéierte Schema virgesinn Sproochoptiounen. De Client sollt nëmmen Text schécken, deen tatsächlech am Demo-Dialog gesprach soll ginn. Eidel Aginn, ongülteg Formater oder eng net aktivéiert Sproochfunktioun mussen als Feeler behandelt ginn. Eng lokal Ännerung vun der Origin oder en Opruff vun enger friemer Domain ëmgeet net déi serverséiteg Préiwung. D'Operatioun erstellt Audio an ass dofir net als idempotent reng Liesoperatioun ze bedruechten. Méifach Schécke vum selwechten Text kann méi Verschaffungsvirgäng auslösen. D'Demo-Uewerfläch sollt de Ausgangsknäppchen während der Verschaffung deaktivéieren a lafend Widderginn propper ophalen, ier eng nei gestart gëtt. En realisteschen Oflaf fänkt mat enger Bot-Äntwert an der Demo un. De Benotzer aktivéiert d'Sproochausgab, d'Säit schéckt den Äntwerttext un `voice-speak`, kritt d'Audiodaten respektiv déi dokumentéiert Audioäntwert a spillt se am Browser of. Scheitert d'Ufro wéinst enger net erlaabter Origin, dierf d'Uewerfläch kee beléibege Ersatzdéngscht opruffen, mä sollt d'Sproochfunktioun als net verfügbar uweisen. Passwierder, Tokens oder vertraulech Inhalter gehéieren net an de Request. De Demo-Kanal ass ëffentlech an net fir geheim Firmendaten geduecht. Och Audioäntwerten sollten net dauerhaft an ëffentleche Logs gespäichert ginn. Den Endpunkt ass technesch vum SIP-Voicebot getrennt. Déi Telefonie leeft an isoléierte SIP-Instanzen pro Mandant a gëtt exklusiv duerch de Master Admin aktivéiert; `voice-speak` steiert keng Ruffnummer a startet kee Telefonuruff. Fir d'Barrièrefräiheet sollt d'Demo nieft der Audioausgab ëmmer de kompletten Text uweisen. D'Sproochausgab dierf keng Informatioun enthalen, déi visuell feelt. Browser kënnen d'Widderginn blockéieren, soulaang keng Benotzerinteraktioun geschitt; dofir sollt de Start bewosst duerch e Klick ausgelöst ginn. Ofbroch an erneit Widderginn mussen kontrolléiert méiglech sinn.

Auth & Absicherung

Keine Authentifizierung erforderlich

Origin-Prüfung fest op https://zentor-app.de / https://www.zentor-app.de (net konfiguréierbar, Ersatz fir Widget-Token um Demo-Pfad).

Idempotent: Ja

Parameter

visitor_id(body, string, erforderlich)— Muss e gültege UUID sinn
text(body, string, erforderlich)— Text, deen an d'Sprooch ëmgewandelt gëtt

Beispiel-Response

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sproochfunktioun ass de Moment net verfügbar"}}

Fehlercodes

400 INVALID_VISITOR_ID — visitor_id ass net verfügbar oder ass net e gültege UUID.
403 ORIGIN_DENIED — Ufro-Origin ass net zentor-app.de.
503 VOICE_UNAVAILABLE — Sproochfunktioun net verfügbar.

Live-Test-Nachweis

Negativ Fäll (400 INVALID_VISITOR_ID, 503 VOICE_UNAVAILABLE, all mat korrekter Origin-Header) live verifizéiert. GET Variant vum selwechte Wee existéiert och (natives <audio src>-Streaming, identesch Verhalen). Demo-Pendant op widget.voice_speak.

← Demo Chatbot an SSO