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

Wandelt eine gesprochene Audioaufnahme der Demo-Seite in Text um (Speech-to-Text), sofern Sprache aktiviert ist. Demo-Pendant zu widget.voice_transcribe, fest an die Zentor-Marketingseite gebunden statt an ein Tenant-Widget.

Auth & Absicherung

Keine Authentifizierung erforderlich

Origin-Pruefung fest auf https://zentor-app.de / https://www.zentor-app.de (nicht konfigurierbar, Ersatz fuer Widget-Token auf dem Demo-Pfad).

Idempotent: Nein

Parameter

visitor_id(body, string, erforderlich)— Muss eine gültige UUID sein
audio(body, file, erforderlich)— multipart/form-data Audiodatei

Beispiel-Response

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id muss eine gültige UUID sein."}}

Fehlercodes

400 INVALID_VISITOR_ID — visitor_id fehlt oder ist keine gültige UUID.
403 ORIGIN_DENIED — Anfrage-Origin ist nicht zentor-app.de.
413 AUDIO_TOO_LARGE — Audiodatei überschreitet das Limit.
415 AUDIO_TYPE_UNSUPPORTED — Audioformat nicht unterstützt.

Live-Test-Nachweis

Negativfälle (400 INVALID_VISITOR_ID mit korrektem Origin-Header, 403 ORIGIN_DENIED) live verifiziert. Erfolgsfall (echte Transkription) außerhalb der Produktionsdomain nicht auslösbar, da die Origin-Prüfung fest auf zentor-app.de kodiert ist — analog zu widget.voice_transcribe dokumentiert.

← Demo-Chatbot und SSO