GET/api/global-chatbot/demo/history
Wczytuje dotychczasową historię wiadomości rozmowy demonstracyjnej, aby zachować ją po ponownym otwarciu demo.
Przekaż `session_id` i `visitor_id` jako parametry zapytania; oba muszą pochodzić z tej samej rozmowy demonstracyjnej. W obiekcie `data` odpowiedź zawiera listę `messages` z `id`, `role`, `text` i `created_at`. Wywołanie jest tylko do odczytu i idempotentne. Jeśli brakuje jednego z parametrów, serwer odpowiada kodem 400 `PARAMS_REQUIRED`. Jeśli sesja nie jest już znana, zacznij nową rozmowę demonstracyjną.
Przegląd
Wywołanie: GET /api/global-chatbot/demo/history. Ten endpoint należy do grupy „Chatbot demonstracyjny i SSO” API Zentor App. Jest publicznie dostępny i nie wymaga uwierzytelniania. Wywołanie jest idempotentne: powtarzane wywołania z tymi samymi danymi zwracają ten sam wynik. Parametry wymagane: session_id (query), visitor_id (query). Udokumentowane przypadki błędów: 400 PARAMS_REQUIRED. Poniższa przykładowa odpowiedź pokazuje strukturę udanej odpowiedzi w formacie JSON.
Uwierzytelnianie i zabezpieczenia
Uwierzytelnianie nie jest wymagane
Idempotentny: Tak
Parametry
session_id(query, string, wymagane)— ID sesji rozmowy demonstracyjnejvisitor_id(query, string, wymagane)— ID odwiedzającego (UUID) generowany przez stronę demoPrzykładowa odpowiedź
{"ok": true, "data": {"messages": [{"id": "f248d929-c9ce-412d-aba8-43808ca1c9f7", "role": "user", "text": "Cześć, ile kosztuje Zentor?", "created_at": "2026-07-20T17:07:02.240Z"}, {"id": "3c26b6a6-4ca6-47a9-9669-a052082007ac", "role": "assistant", "text": "Pokażę Ci, jak to wyglądałoby w Twoim przypadku – bez zobowiązań.", "created_at": "2026-07-20T17:07:02.329Z"}]}}Kody błędów
400 PARAMS_REQUIRED — Brakuje `session_id` lub `visitor_id`.Zweryfikowane zachowanie
Istniejąca sesja demo zwraca 200 z historią; brakujące parametry zwracają 400 `PARAMS_REQUIRED`.
Chatbot demonstracyjny i SSO
POST /api/global-chatbot/demoWysyła wiadomość do publicznego chatbota demonstracyjnego na zentor-app.de/demo i zwraca jego odpowiedź. Demo można wypróbować w przeglądarce bez rejestracji.POST /api/global-chatbot/demo/pollPobiera nowe wiadomości rozmowy demonstracyjnej, np. gdy pracownik Zentor przejął rozmowę. Strona demo wywołuje endpoint w odstępach czasu.POST /api/global-chatbot/demo/ratingZapisuje ocenę rozmowy demonstracyjnej (pomocna lub niepomocna) z opcjonalnym komentarzem.POST /api/global-chatbot/demo/trackRejestruje anonimowe zdarzenia użycia strony demo na potrzeby statystyk odwiedzających Zentor.POST /api/global-chatbot/demo/voice-transcribeZamienia nagranie głosowe na stronie demo na tekst (wejście głosowe), jeśli funkcja głosowa demo jest włączona.POST /api/global-chatbot/demo/voice-speakZamienia tekst na mowę (wyjście głosowe na stronie demo), jeśli funkcja głosowa demo jest włączona.GET /api/sso/:tenantSlug/statusSprawdza, czy jednokrotne logowanie (SAML lub OIDC) jest skonfigurowane dla konta. Strona logowania wykorzystuje wynik, aby zaproponować logowanie SSO.GET /api/sso/:tenantSlug/oidc/startUruchamia logowanie przez OpenID Connect i przekierowuje przeglądarkę do skonfigurowanego dostawcy identyfikacji.GET /api/sso/:tenantSlug/oidc/callbackOdbiera przekierowanie dostawcy identyfikacji po zalogowaniu OIDC i przekierowuje przeglądarkę z powrotem do Zentor App.GET /api/sso/:tenantSlug/saml/startUruchamia logowanie przez SAML i przekierowuje przeglądarkę do skonfigurowanego dostawcy identyfikacji.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): odbiera podpisaną odpowiedź SAML od dostawcy identyfikacji poprzez formularzowy POST.GET /api/sso/:tenantSlug/saml/metadataZwraca metadane SAML Zentor App (XML) do zaimportowania w Państwa dostawcy identyfikacji.