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

Converts text into spoken audio (text-to-speech) for voice output on the demo page, if enabled.

Auth & Security

No authentication required

Origin check fixed to https://zentor-app.de / https://www.zentor-app.de (not configurable, replacement for Widget-Token on the demo path).

Idempotent: Yes

Parameters

visitor_id(body, string, required)— Must be a valid UUID
text(body, string, required)— Text to be converted into speech

Example Response

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

Error Codes

400 INVALID_VISITOR_ID — visitor_id is missing or not a valid UUID.
403 ORIGIN_DENIED — Request origin is not zentor-app.de.
503 VOICE_UNAVAILABLE — Voice feature currently unavailable.

Live Test Proof

Negative cases (400 INVALID_VISITOR_ID, 503 VOICE_UNAVAILABLE, each with correct origin header) live-verified. A GET variant of the same path also exists (native <audio src> streaming, identical behavior). Demo counterpart to widget.voice_speak.

← Demo Chatbot and SSO