GET/api/global-chatbot/demo/history

Ilayisha umlando wemiyalezo yangaphambilini wengxoxo yedemo ukuze igcinwe uma idemo ivulwa kabusha.

Dlulisela `session_id` ne`visitor_id` njengamapharamitha wombuzo; womabili kumele avele kuyona ingxoxo yedemo efanayo. Impendulo iqukethe enjinini ethi `data` uhlu lwethi `messages` nge`id`, `role`, `text` ne`created_at`. Isibizo sifunda kuphela futhi sihlangene. Uma kushoda inye yamapharamitha, iseva iphendula ngo-400 `PARAMS_REQUIRED`. Uma iseshini ingasaziwa, qala ingxoxo entsha yedemo.

Ukubuka konke

Ukubiza: GET /api/global-chatbot/demo/history. Le endpoint ingeyeqembu elithi “Idemo ye-chatbot ne-SSO” le-API ye-Zentor App. Ifinyeleleka esidlangalaleni futhi ayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza kuyi-idempotent: ukubiza kaningi ngemininingwane efanayo kubuyisa umphumela ofanayo. Amapharamitha ayimpoqo: session_id (query), visitor_id (query). Izimo zamaphutha ezibhaliwe: 400 PARAMS_REQUIRED. Isibonelo sempendulo ngezansi sibonisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.

Ukuqinisekisa ubunikazi nokuvikeleka

Akudingeki ukuqinisekisa ubunikazi

I-idempotent: Yebo

Amapharamitha

session_id(query, string, kuyadingeka)— I-ID yeseshini yengxoxo yedemo
visitor_id(query, string, kuyadingeka)— I-ID yesivakashi (UUID) ekhiqizwa ikhasi lwedemo

Isibonelo se-response

{"ok":true,"data":{"messages":[{"id":"f248d929-c9ce-412d-aba8-43808ca1c9f7","role":"user","text":"Sawubona, kubiza malini i-Zentor?","created_at":"2026-07-20T17:07:02.240Z"},{"id":"3c26b6a6-4ca6-47a9-9669-a052082007ac","role":"assistant","text":"Ngingakukhombisa ukuthi lokhu kungabukeka kanjani esimweni sakho — ngaphandle kwesibopho.","created_at":"2026-07-20T17:07:02.329Z"}]}}

Amakhodi amaphutha

400 PARAMS_REQUIRED — I-`session_id` noma i-`visitor_id` ayikho.

Ukuziphatha okuhlolwe

Iseshini yedemo ekhona inikeza u-200 ngomlando; amamethrameta angekho anikeza u-400 `PARAMS_REQUIRED`.

Idemo ye-chatbot ne-SSO

POST /api/global-chatbot/demoIthumela umlayezo kubhothi lokubonisa yomphakathi ku-zentor-app.de/demo futhi inikeze impendulo yayo. Idemo ingazanywa ngaphandle kobhalisi kubhrawuza.POST /api/global-chatbot/demo/pollLithatha imiyalezo emisha yengxoxo yedemo, isibonelo uma isisebenzi se-Zentor sithatha ingxoxo. Ikhasi ledemo libiza isixhumi ngezikhathi ezihleliwe.POST /api/global-chatbot/demo/ratingIgcina ukuhlolwa kwengxoxo yedemo (okusizile noma okungasizile) ngokuphawula okukhethekile.POST /api/global-chatbot/demo/trackIrekhoda izenzakalo zokusetshenziswa ezingaziwa zekhasi ledemo zamanani wezivakashi ze-Zentor.POST /api/global-chatbot/demo/voice-transcribeIguqula ukuqoshwa kwezwi ekhasini ledemo kube ngumbhalo (okungenayo kwezwi), uma umsebenzi wezwi wedemo uvuliwe.POST /api/global-chatbot/demo/voice-speakIguqula umbhalo ube yinkulumo (umsindo wasekhaya wekhulumo kukhasi lwedemo), uma umsebenzi wenkulumo wedemo uvuliwe.GET /api/sso/:tenantSlug/statusIhlola ukuthi ukungena kanye (SAML noma OIDC) kulungiswe yini ku-akhawunti. Ikhasi lokungena lisebenzisa umphumela ukuze linikeze ukungena nge-SSO.GET /api/sso/:tenantSlug/oidc/startIqala ukungena nge-OpenID Connect futhi idlulisele isiphequluli kumhlinzeki womazisi olungiswe.GET /api/sso/:tenantSlug/oidc/callbackYamukela ukudluliselwa komhlinzeki womazisi ngemva kokungena nge-OIDC futhi ibuyisele isiphequluli ku-Zentor App.GET /api/sso/:tenantSlug/saml/startIqala ukungena nge-SAML futhi idlulisele isiphequluli kumhlinzeki womazisi olungiswe.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): yamukela impendulo ye-SAML esayiniwe yomhlinzeki womazisi nge-POST yefomu.GET /api/sso/:tenantSlug/saml/metadataInikeza imininingwane ye-SAML ye-Zentor App (XML) ukuba ifakwe emhlinzekini wenu womazisi.

Izihloko ezihlobene

← Idemo ye-chatbot ne-SSO