POST/api/public/widget/voice-transcribe

Wandelt eine gesprochene Audioaufnahme des Besuchers in Text um (Speech-to-Text), sofern die Sprachfunktion für das Widget aktiviert ist.

Auth & Absicherung

Widget-Embed-Token (Header X-Widget-Token) + Origin-Freigabeliste

Idempotent: Nein

Parameter

widget_code(body, string, erforderlich)
audio(body, binary, erforderlich)— Audiodaten zur Transkription

Beispiel-Response

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

Fehlercodes

400 WIDGET_CODE_REQUIRED — widget_code fehlt.
503 VOICE_UNAVAILABLE — Sprachfunktion ist für dieses Widget nicht aktiviert.

Live-Test-Nachweis

Negativfälle (400 fehlendes Feld, 503 Sprachfunktion nicht aktiviert) live verifiziert. Ein Erfolgsfall würde ein aktiviertes Voice-Widget mit echtem Audio und einem konfigurierten Spracherkennungs-Provider erfordern — nicht nachgestellt.

← Chat-Widget