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) для імпорту у вашого провайдера ідентифікації.