GET/api/global-chatbot/demo/history

Ilayitsha umlando wemilayezo wangaphambilini wengxoxo yedemo ukuthi igcinwe nxa idemo ivulwa kutsha.

Dluliselani `session_id` le`visitor_id` njengamapharamitha wombuzo; womabili kumele avele kuyona ingxoxo yedemo efananayo. Impendulo iqukethe kwinjini ethi `data` uhlu lwethi `messages` nge`id`, `role`, `text` le`created_at`. Lesibizo sifunda kuphela njalo siyahambisana. Nxa kuswela enye yamapharamitha, iseva iphendula ngo-400 `PARAMS_REQUIRED`. Nxa iseshini ingaselaziwa, qalisani ingxoxo entsha yedemo.

Isifinyezo

Ukubiza: GET /api/global-chatbot/demo/history. Le endpoint ingeyeqembu elithi “Idemo ye-chatbot le-SSO” le-API ye-Zentor App. Ifinyeleleka emphakathini njalo kayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza kuyi-idempotent: ukubiza kanengi ngemininingwane efananayo kubuyisela umphumela ofananayo. Amapharamitha adingekayo: session_id (query), visitor_id (query). Izimo zamaphutha ezibhaliweyo: 400 PARAMS_REQUIRED. Isibonelo sempendulo ngezansi sitshengisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.

Ukuqinisekisa ubuwena lokuvikeleka

Kakudingeki ukuqinisekisa ubuwena

I-idempotent: Yebo

Amapharamitha

session_id(query, string, kuyadingeka)— I-ID yeseshini yengxoxo yedemo
visitor_id(query, string, kuyadingeka)— I-ID yesivakatshi (UUID) ekhiqizwa likhasi ledemo

Isibonelo sempendulo (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":"Ngingakubonisa ukuthi lokhu kungabukeka kanjani ekusetshenzisweni kwakho — ngaphandle kwesibopho.","created_at":"2026-07-20T17:07:02.329Z"}]}}

Amakhodi amaphutha

400 PARAMS_REQUIRED — I-`session_id` kumbe i-`visitor_id` kayikho.

Ukuziphatha okuhlolwe

Iseshini yedemo ekhona inika u-200 lomlando; amamethrameta angekho anika u-400 `PARAMS_REQUIRED`.

Idemo ye-chatbot le-SSO

POST /api/global-chatbot/demoIthumela umlayezo kubhothi lokubonisa yomphakathi ku-zentor-app.de/demo njalo inikeze impendulo yayo. Idemo ingazanywa ngaphandle kokubhalisa kubhrawuza.POST /api/global-chatbot/demo/pollLithatha imilayezo emitsha yengxoxo yedemo, isibonelo nxa isisebenzi seZentor sithatha ingxoxo. Ikhasi ledemo libiza isihlanganiso ngezikhathi ezihleliweyo.POST /api/global-chatbot/demo/ratingIgcina ukuhlolwa kwengxoxo yedemo (okusiza kumbe okungasizi) ngokuphawula okukhethiweyo.POST /api/global-chatbot/demo/trackIrekhoda izenzakalo zokusetshenziswa ezingaziwayo zekhasi ledemo zamanani wezivakatshi zeZentor.POST /api/global-chatbot/demo/voice-transcribeIguqula ukuqoshwa kwezwi ekhasini ledemo kube umbhalo (ukungena kwezwi), nxa umsebenzi wezwi wedemo uvuliwe.POST /api/global-chatbot/demo/voice-speakIguqula umbhalo ube yikhulumo (umsindo kukhasi ledemo), nxa umsebenzi wenkulumo wedemo uvuliwe.GET /api/sso/:tenantSlug/statusIhlola ukuthi ukungena kanye (SAML kumbe OIDC) kulungiswe yini ku-akhawunti. Ikhasi lokungena lisebenzisa umphumela ukuze linikeze ukungena nge-SSO.GET /api/sso/:tenantSlug/oidc/startIqala ukungena nge-OpenID Connect njalo idlulisela isikhangeli kumnikezeli wesazisi olungiswe.GET /api/sso/:tenantSlug/oidc/callbackYamukela ukudluliselwa komnikezeli wesazisi ngemva kokungena nge-OIDC njalo ibuyisela isikhangeli kuZentor App.GET /api/sso/:tenantSlug/saml/startIqala ukungena nge-SAML njalo idlulisela isikhangeli kumnikezeli wesazisi olungiswe.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): yamukela impendulo ye-SAML esayinweyo yomnikezeli wesazisi nge-POST yefomu.GET /api/sso/:tenantSlug/saml/metadataInikeza imininingwane ye-SAML yeZentor App (XML) ukuba ifakwe emnikezelini wenu wesazisi.

Izihloko ezihlobene

← Idemo ye-chatbot le-SSO