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

Преобразует голосовую запись на странице демо в текст (голосовой ввод), если голосовая функция демо активирована.

Отправьте `visitor_id` (UUID) и аудиофайл в поле `audio` как `multipart/form-data`. Ответ содержит распознанный текст. Эндпоинт соответствует `POST /api/public/widget/voice-transcribe`, но привязан к демо на zentor-app.de. Случаи ошибок: 400 `INVALID_VISITOR_ID` (отсутствующий или недействительный UUID), 403 `ORIGIN_DENIED` (вызов не с zentor-app.de), 413 `AUDIO_TOO_LARGE` (файл слишком большой) и 415 `AUDIO_TYPE_UNSUPPORTED` (формат не поддерживается).

Обзор

Вызов: POST /api/global-chatbot/demo/voice-transcribe. Этот эндпоинт относится к группе «Демо-чат-бот и SSO» API Zentor App. Он общедоступен и не требует аутентификации. Вызов не идемпотентен: каждый успешный вызов заново запускает действие. Обязательные параметры: visitor_id (тело), audio (тело). Задокументированные случаи ошибок: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. Пример ответа ниже показывает структуру успешного ответа в формате JSON.

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

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

Принимает только вызовы с https://zentor-app.de и https://www.zentor-app.de; embed-токен для демо не требуется.

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

Параметры

visitor_id(body, string, обязательно)— ID посетителя, должен быть действительным 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 — Вызов не поступает с zentor-app.de.
413 AUDIO_TOO_LARGE — Аудиофайл превышает допустимый размер.
415 AUDIO_TYPE_UNSUPPORTED — Аудиоформат не поддерживается.

Проверенное поведение

Недействительный `visitor_id` возвращает 400 `INVALID_VISITOR_ID`, вызов с другого домена — 403 `ORIGIN_DENIED`. Успешный случай возможен только с zentor-app.de.

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

POST /api/global-chatbot/demoОтправляет сообщение публичному демо-чат-боту на zentor-app.de/demo и возвращает его ответ. Демо можно опробовать в браузере без регистрации.GET /api/global-chatbot/demo/historyЗагружает предыдущую историю сообщений демо-разговора, чтобы она сохранялась при повторном открытии демо.POST /api/global-chatbot/demo/pollПолучает новые сообщения демо-разговора, например когда сотрудник Zentor взял разговор на себя. Страница демо вызывает эндпоинт с интервалами.POST /api/global-chatbot/demo/ratingСохраняет оценку демо-разговора (полезно или бесполезно) с необязательным комментарием.POST /api/global-chatbot/demo/trackФиксирует анонимные события использования страницы демо для статистики посетителей Zentor.POST /api/global-chatbot/demo/voice-speakПреобразует текст в речь (голосовой вывод на странице демо), если голосовая функция демо активирована.GET /api/sso/:tenantSlug/statusПроверяет, настроен ли для аккаунта единый вход (SAML или OIDC). Страница входа использует результат, чтобы предложить вход через SSO.GET /api/sso/:tenantSlug/oidc/startЗапускает вход через OpenID Connect и перенаправляет браузер к настроенному провайдеру идентификации.GET /api/sso/:tenantSlug/oidc/callbackПринимает перенаправление от провайдера идентификации после входа через OIDC и перенаправляет браузер обратно к Zentor App.GET /api/sso/:tenantSlug/saml/startЗапускает вход через SAML и перенаправляет браузер к настроенному провайдеру идентификации.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): принимает подписанный SAML-ответ провайдера идентификации через форму POST.GET /api/sso/:tenantSlug/saml/metadataВозвращает SAML-метаданные Zentor App (XML) для импорта в вашего провайдера идентификации.

Связанные статьи

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