POST/api/global-chatbot/demo/voice-speak
Преобразует текст в речь (голосовой вывод на странице демо), если голосовая функция демо активирована.
Отправьте `visitor_id` (UUID) и текст для озвучивания в `text`. Ответ содержит аудиоданные для воспроизведения; для элемента `<audio>` тот же путь дополнительно доступен через GET. Эндпоинт соответствует `POST /api/public/widget/voice-speak`, но привязан к демо на zentor-app.de и не предназначен как общий интерфейс синтеза речи. Случаи ошибок: 400 `INVALID_VISITOR_ID` (отсутствующий или недействительный UUID), 403 `ORIGIN_DENIED` (вызов не с zentor-app.de) и 503 `VOICE_UNAVAILABLE` (голосовая функция временно недоступна).
Обзор
Вызов: POST /api/global-chatbot/demo/voice-speak. Этот эндпоинт относится к группе «Демо-чат-бот и SSO» API Zentor App. Он общедоступен и не требует аутентификации. Вызов идемпотентен: повторные вызовы с теми же данными возвращают тот же результат. Обязательные параметры: visitor_id (тело), text (тело). Задокументированные случаи ошибок: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE. Пример ответа ниже показывает структуру успешного ответа в формате JSON.
Аутентификация и защита
Аутентификация не требуется
Принимает только вызовы с https://zentor-app.de и https://www.zentor-app.de; embed-токен для демо не требуется.
Идемпотентный: Да
Параметры
visitor_id(body, string, обязательно)— ID посетителя, должен быть действительным UUIDtext(body, string, обязательно)— Текст, который нужно озвучитьПример ответа
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Функция речи в настоящее время недоступна."}}Коды ошибок
400 INVALID_VISITOR_ID — `visitor_id` отсутствует или не является действительным UUID.403 ORIGIN_DENIED — Вызов не поступает с zentor-app.de.503 VOICE_UNAVAILABLE — Голосовая функция сейчас недоступна.Проверенное поведение
Недействительный `visitor_id` возвращает 400 `INVALID_VISITOR_ID`, недоступная голосовая функция — 503 `VOICE_UNAVAILABLE`. Успешный случай возможен только с 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-transcribeПреобразует голосовую запись на странице демо в текст (голосовой ввод), если голосовая функция демо активирована.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) для импорта в вашего провайдера идентификации.