POST/api/public/widget/voice-speak

Converts text into spoken audio (text-to-speech) for voice output in the widget, if enabled.

Auth & Security

Widget embed token (X-Widget-Token header) + origin allowlist

Idempotent: Yes

Parameters

widget_code(body, string, required)
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 WIDGET_CODE_REQUIRED — widget_code is missing.
503 VOICE_UNAVAILABLE — Voice function is not enabled for this widget.

Live Test Proof

Negative cases (400, 503) verified live for POST. A GET variant of the same path also exists (identical behavior per auto-extraction), not separately re-tested.

← Chat Widget