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

Converte uma gravação de voz da página Demo em texto (Speech-to-Text), se voz estiver ativa. Equivalente Demo de widget.voice_transcribe, associado fixamente à página de marketing Zentor em vez de a um widget de tenant.

Autenticação e segurança

Não é necessária autenticação

Verificação de Origin fixa em https://zentor-app.de / https://www.zentor-app.de (não configurável, substitui o Widget-Token no caminho da demo).

Idempotente: Não

Parâmetros

visitor_id(body, string, obrigatório)— Tem de ser uma UUID válida
audio(body, file, obrigatório)— ficheiro de áudio multipart/form-data

Resposta de exemplo

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

Códigos de erro

400 INVALID_VISITOR_ID — visitor_id em falta ou não é uma UUID válida.
403 ORIGIN_DENIED — A Origin do pedido não é zentor-app.de.
413 AUDIO_TOO_LARGE — O ficheiro de áudio excede o limite.
415 AUDIO_TYPE_UNSUPPORTED — Formato de áudio não suportado.

Evidência de teste live

Casos negativos (400 INVALID_VISITOR_ID com header Origin correto, 403 ORIGIN_DENIED) verificados live. O caso de sucesso (transcrição real) não pode ser acionado fora do domínio de produção porque a verificação de Origin está codificada para zentor-app.de — documentado de forma análoga a widget.voice_transcribe.

← Chatbot Demo e SSO