GET/api/global-chatbot/demo/history

Načíta doterajšiu históriu správ demo konverzácie, aby sa zachovala pri opätovnom otvorení dema.

Predajte `session_id` a `visitor_id` ako parametre dotazu; oba musia pochádzať z rovnakej demo konverzácie. V objekte `data` obsahuje odpoveď zoznam `messages` s `id`, `role`, `text` a `created_at`. Volanie je len na čítanie a idempotentné. Chýba-li niektorý z parametrov, server odpovie kódom 400 `PARAMS_REQUIRED`. Ak relácia už nie je známa, začnite novú demo konverzáciu.

Prehľad

Volanie: GET /api/global-chatbot/demo/history. Tento endpoint patrí do skupiny „Demo chatbot a SSO“ API aplikácie Zentor App. Je verejne dostupný a nevyžaduje žiadnu autentifikáciu. Volanie je idempotentné: Opakované volania s rovnakými údajmi vracajú rovnaký výsledok. Povinné parametre: session_id (query), visitor_id (query). Zdokumentované chybové prípady: 400 PARAMS_REQUIRED. Ukážková odpoveď nižšie zobrazuje štruktúru úspešnej odpovede vo formáte JSON.

Autentifikácia a zabezpečenie

Nevyžaduje sa žiadna autentifikácia

Idempotentné: Áno

Parametre

session_id(query, string, povinné)— ID relácie demo konverzácie
visitor_id(query, string, povinné)— ID návštevníka (UUID) generované demo stránkou

Príklad odpovede

{"ok": true, "data": {"messages": [{"id": "f248d929-c9ce-412d-aba8-43808ca1c9f7", "role": "user", "text": "Ahoj, koľko stojí Zentor?", "created_at": "2026-07-20T17:07:02.240Z"}, {"id": "3c26b6a6-4ca6-47a9-9669-a052082007ac", "role": "assistant", "text": "Môžem vám ukázať, ako by to vyzeralo pre váš prípad použitia – bez záväzku.", "created_at": "2026-07-20T17:07:02.329Z"}]}}

Chybové kódy

400 PARAMS_REQUIRED — Chýba `session_id` alebo `visitor_id`.

Overené správanie

Existujúca demo relácia vracia 200 s históriou; chýbajúce parametre vracajú 400 `PARAMS_REQUIRED`.

Demo chatbot a SSO

POST /api/global-chatbot/demoOdošle správu verejnému demo chatbotovi na zentor-app.de/demo a vráti jeho odpoveď. Demo je možné vyskúšať v prehliadači bez registrácie.POST /api/global-chatbot/demo/pollZískava nové správy demo konverzácie, napríklad ak konverzáciu prevzal pracovník Zentoru. Demo stránka volá endpoint v intervaloch.POST /api/global-chatbot/demo/ratingUloží hodnotenie demo konverzácie (užitočná alebo neužitočná) s nepovinným komentárom.POST /api/global-chatbot/demo/trackZaznamenáva anonymné udalosti využitia demo stránky pre štatistiku návštevníkov Zentoru.POST /api/global-chatbot/demo/voice-transcribePrevádza hlasový záznam na demo stránke na text (hlasový vstup), ak je hlasová funkcia dema aktivovaná.POST /api/global-chatbot/demo/voice-speakPrevádza text na hovorenú reč (hlasový výstup na demo stránke), ak je hlasová funkcia dema aktivovaná.GET /api/sso/:tenantSlug/statusSkontroluje, či je pre účet nastavené jednotné prihlásenie (SAML alebo OIDC). Prihlasovacia stránka použije výsledok na ponúknutie prihlásenia cez SSO.GET /api/sso/:tenantSlug/oidc/startSpustí prihlásenie cez OpenID Connect a presmeruje prehliadač na nastaveného poskytovateľa identity.GET /api/sso/:tenantSlug/oidc/callbackPrijíma presmerovanie poskytovateľa identity po prihlásení OIDC a presmeruje prehliadač späť na Zentor App.GET /api/sso/:tenantSlug/saml/startSpustí prihlásenie cez SAML a presmeruje prehliadač na nastaveného poskytovateľa identity.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): prijíma podpísanú odpoveď SAML od poskytovateľa identity formulárovým POST.GET /api/sso/:tenantSlug/saml/metadataVracia metadáta SAML Zentor App (XML) na import do vášho poskytovateľa identity.

Súvisiace články

← Demo chatbot a SSO