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

Omvandlar en talad ljudinspelning från demosidan till text (speech-to-text), om tal är aktiverat. Demomotsvarighet till widget.voice_transcribe, fast kopplad till Zentors marknadsföringssida i stället för en tenant-widget.

Autentisering & säkerhet

Ingen autentisering krävs

Origin-kontroll fast inställd på https://zentor-app.de / https://www.zentor-app.de (inte konfigurerbar, ersätter widget-token på demovägen).

Idempotent: Nej

Parametrar

visitor_id(body, string, obligatorisk)— Måste vara en giltig UUID
audio(body, file, obligatorisk)— multipart/form-data ljudfil

Exempel på response

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id måste vara en giltig UUID."}}

Felkoder

400 INVALID_VISITOR_ID — visitor_id saknas eller är ingen giltig UUID.
403 ORIGIN_DENIED — Förfrågans ursprung (origin) är inte zentor-app.de.
413 AUDIO_TOO_LARGE — Ljudfilen överskrider gränsen.
415 AUDIO_TYPE_UNSUPPORTED — Ljudformatet stöds inte.

Bevis från livetest

Negativa fall (400 INVALID_VISITOR_ID med korrekt Origin-header, 403 ORIGIN_DENIED) verifierade live. Framgångsfallet (verklig transkription) kan inte utlösas utanför produktionsdomänen eftersom origin-kontrollen är hårdkodad till zentor-app.de — dokumenterat analogt med widget.voice_transcribe.

← Demo-chattbot och SSO