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

Преобразует голосовую аудиозапись с демо-страницы в текст (speech-to-text), если голосовая функция активирована. Демо-аналог widget.voice_transcribe, жёстко привязанный к маркетинговой странице Zentor, а не к виджету тенанта.

Аутентификация и защита

Аутентификация не требуется

Проверка Origin жёстко задана на https://zentor-app.de / https://www.zentor-app.de (не настраивается, заменяет токен виджета на демо-пути).

Идемпотентный: Нет

Параметры

visitor_id(body, string, обязательно)— Должна быть валидной UUID
audio(body, file, обязательно)— multipart/form-data Аудиофайл

Пример ответа

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id должен быть действительным UUID."}}

Коды ошибок

400 INVALID_VISITOR_ID — visitor_id отсутствует или не является корректной UUID.
403 ORIGIN_DENIED — Origin запроса — не zentor-app.de.
413 AUDIO_TOO_LARGE — Аудиофайл превышает лимит.
415 AUDIO_TYPE_UNSUPPORTED — Неподдерживаемый формат аудио.

Подтверждение живого теста

Негативные случаи (400 INVALID_VISITOR_ID с корректным заголовком Origin, 403 ORIGIN_DENIED) проверены вживую. Успешный случай (настоящая транскрипция) вне продакшен-домена вызвать невозможно, так как проверка Origin жёстко закодирована на zentor-app.de — задокументировано по аналогии с widget.voice_transcribe.

← Демо-чат-бот и SSO