POST/api/public/widget/voice-transcribe

Converts a spoken audio recording from the visitor into text (speech-to-text), if voice is enabled for the widget.

Auth & Security

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

Idempotent: No

Parameters

widget_code(body, string, required)
audio(body, binary, required)— Audio data for transcription

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 missing field, 503 voice function not enabled) verified live. A success case would require an activated voice widget with real audio and a configured speech recognition provider — not reproduced.

← Chat Widget