GET/api/global-chatbot/demo/history
Ngarkon historinë e mëparshme të mesazheve të një bisede demo, që të ruhet kur demo-ja hapet përsëri.
Kaloni `session_id` dhe `visitor_id` si parametra kërkese; të dyja duhet të jenë nga e njëjta bisedë demo. Përgjigja përmban në objektin `data` listën `messages` me `id`, `role`, `text` dhe `created_at`. Thirrja është vetëm për lexim dhe idempotente. Nëse mungon një nga parametrat, serveri përgjigjet me 400 `PARAMS_REQUIRED`. Nëse seanca nuk njihet më, nisni një bisedë demo të re.
Përmbledhje
Thirrja: GET /api/global-chatbot/demo/history. Ky endpoint i përket grupit “Demo-chatbot dhe SSO” të API-së së Zentor App. Është i aksesueshëm publikisht dhe nuk kërkon autentifikim. Thirrja është idempotente: thirrjet e përsëritura me të njëjtat të dhëna kthejnë të njëjtin rezultat. Parametrat e detyrueshëm: session_id (query), visitor_id (query). Rastet e dokumentuara të gabimeve: 400 PARAMS_REQUIRED. Përgjigjja shembull më poshtë tregon strukturën e një përgjigjeje të suksesshme në formatin JSON.
Autentifikimi dhe siguria
Nuk kërkohet autentifikim
Idempotent: Po
Parametrat
session_id(query, string, i detyrueshëm)— ID-ja e seancës së bisedës demovisitor_id(query, string, i detyrueshëm)— ID-ja e vizitorit (UUID) e krijuar nga faqja demoShembull response-i
{"ok":true,"data":{"messages":[{"id":"f248d929-c9ce-412d-aba8-43808ca1c9f7","role":"user","text":"Përshëndetje, sa kushton Zentor?","created_at":"2026-07-20T17:07:02.240Z"},{"id":"3c26b6a6-4ca6-47a9-9669-a052082007ac","role":"assistant","text":"Mund të të tregoj si do të dukej kjo për rastin tënd të përdorimit — pa detyrim.","created_at":"2026-07-20T17:07:02.329Z"}]}}Kodet e gabimeve
400 PARAMS_REQUIRED — `session_id` ose `visitor_id` mungon.Sjellja e verifikuar
Një seancë demo ekzistuese kthen 200 me historinë; parametrat që mungojnë kthejnë 400 `PARAMS_REQUIRED`.
Demo-chatbot dhe SSO
POST /api/global-chatbot/demoDërgon një mesazh te chatbot-i publik demo në zentor-app.de/demo dhe kthen përgjigjen e tij. Demo-ja mund të provohet në shfletues pa regjistrim.POST /api/global-chatbot/demo/pollMerr mesazhet e reja të një bisede demo, për shembull kur një punonjës i Zentor e ka marrë përsipër bisedën. Faqja demo e thërret endpoint-in në intervale.POST /api/global-chatbot/demo/ratingRuaj vlerësimin e një bisede demo (e dobishme ose jo e dobishme) me koment opsional.POST /api/global-chatbot/demo/trackRegjistron ngjarje anonime të përdorimit të faqes demo për statistikat e vizitorëve të Zentor.POST /api/global-chatbot/demo/voice-transcribeKonverton një regjistrim zanor në faqen demo në tekst (hyrje me zë), nëse funksioni i zërit i demo-s është i aktivizuar.POST /api/global-chatbot/demo/voice-speakKonverton tekstin në të folur (prodhim zanor në faqen demo), nëse funksioni i zërit i demo-s është i aktivizuar.GET /api/sso/:tenantSlug/statusKontrollon nëse për një llogari është konfiguruar hyrja e njëhershme (SAML ose OIDC). Faqja e hyrjes e përdor rezultatin për të ofruar hyrjen SSO.GET /api/sso/:tenantSlug/oidc/startNis identifikimin përmes OpenID Connect dhe ridrejton shfletuesin te ofruesi i identitetit i konfiguruar.GET /api/sso/:tenantSlug/oidc/callbackPranon ridrejtimin e ofruesit të identitetit pas hyrjes OIDC dhe ridrejton shfletuesin përsëri te Zentor App.GET /api/sso/:tenantSlug/saml/startNis identifikimin përmes SAML dhe ridrejton shfletuesin te ofruesi i identitetit i konfiguruar.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): pranon përgjigjen e nënshkruar SAML të ofruesit të identitetit përmes formularit POST.GET /api/sso/:tenantSlug/saml/metadataKthen metadatat SAML të Zentor App (XML) për importim në ofruesin tuaj të identitetit.