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