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

Converte in testo una registrazione vocale della pagina Demo (Speech-to-Text) se la funzione vocale è attiva. Equivalente Demo di widget.voice_transcribe, legato rigidamente alla pagina marketing Zentor invece che a un widget Tenant.

Autenticazione e sicurezza

Nessuna autenticazione richiesta

Controllo Origin fissato su https://zentor-app.de / https://www.zentor-app.de (non configurabile, sostituisce il Widget-Token nel percorso demo).

Idempotente: No

Parametri

visitor_id(body, string, obbligatorio)— Deve essere una UUID valida
audio(body, file, obbligatorio)— file audio multipart/form-data

Risposta di esempio

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

Codici di errore

400 INVALID_VISITOR_ID — visitor_id mancante o non è una UUID valida.
403 ORIGIN_DENIED — La Origin del request non è zentor-app.de.
413 AUDIO_TOO_LARGE — Il file audio supera il limite.
415 AUDIO_TYPE_UNSUPPORTED — Formato audio non supportato.

Prova del test live

Casi negativi (400 INVALID_VISITOR_ID con header Origin corretto, 403 ORIGIN_DENIED) verificati live. Caso di successo (vera trascrizione) non attivabile fuori dal dominio produzione perché la verifica Origin è codificata rigidamente su zentor-app.de — documentato in analogia a widget.voice_transcribe.

← Chatbot Demo e SSO