GET/api/global-chatbot/demo/history

Загружает предыдущую историю сообщений демо-разговора, чтобы она сохранялась при повторном открытии демо.

Передайте `session_id` и `visitor_id` как query-параметры; оба должны быть из одной и той же демо-беседы. Ответ содержит в объекте `data` список `messages` с `id`, `role`, `text` и `created_at`. Вызов только для чтения и идемпотентен. Если отсутствует один из параметров, сервер отвечает кодом 400 `PARAMS_REQUIRED`. Если сессия больше не известна, начните новую демо-беседу.

Обзор

Вызов: GET /api/global-chatbot/demo/history. Этот эндпоинт относится к группе «Демо-чат-бот и SSO» API Zentor App. Он общедоступен и не требует аутентификации. Вызов идемпотентен: повторные вызовы с теми же данными возвращают тот же результат. Обязательные параметры: session_id (query), visitor_id (query). Задокументированные случаи ошибок: 400 PARAMS_REQUIRED. Пример ответа ниже показывает структуру успешного ответа в формате JSON.

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

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

Идемпотентный: Да

Параметры

session_id(query, string, обязательно)— ID сессии демо-беседы
visitor_id(query, string, обязательно)— ID посетителя (UUID), который создаёт страница демо

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

{"ok":true,"data":{"messages":[{"id":"f248d929-c9ce-412d-aba8-43808ca1c9f7","role":"user","text":"Здравствуйте, сколько стоит Zentor?","created_at":"2026-07-20T17:07:02.240Z"},{"id":"3c26b6a6-4ca6-47a9-9669-a052082007ac","role":"assistant","text":"Я могу показать, как это будет выглядеть для вашего сценария — без обязательств.","created_at":"2026-07-20T17:07:02.329Z"}]}}

Коды ошибок

400 PARAMS_REQUIRED — `session_id` или `visitor_id` отсутствует.

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

Существующая демо-сессия возвращает 200 с историей; отсутствующие параметры возвращают 400 `PARAMS_REQUIRED`.

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

POST /api/global-chatbot/demoОтправляет сообщение публичному демо-чат-боту на zentor-app.de/demo и возвращает его ответ. Демо можно опробовать в браузере без регистрации.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Преобразует голосовую запись на странице демо в текст (голосовой ввод), если голосовая функция демо активирована.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