GET/api/global-chatbot/demo/history
Hupakia historia ya awali ya ujumbe wa mazungumzo ya onyesho ili ihifadhiwe wakati onyesho linapofunguliwa tena.
Tumeni `session_id` na `visitor_id` kama vigezo vya swali; vyote viwili lazima vitoke kwenye mazungumzo yale yale ya onyesho. Jibu lina katika kitu `data` orodha `messages` yenye `id`, `role`, `text` na `created_at`. Wito huu ni wa kusoma tu na idempotent. Ikiwa kigezo kimoja hakipo, seva hujibu na 400 `PARAMS_REQUIRED`. Ikiwa kipindi hakijulikani tena, anzisheni mazungumzo mapya ya onyesho.
Muhtasari
Mwito: GET /api/global-chatbot/demo/history. Endpoint hii ni sehemu ya kundi la “Chatbot ya demo na SSO” la API ya Zentor App. Inafikika hadharani na haihitaji uthibitishaji. Mwito huu ni idempotent: miito inayorudiwa yenye data ileile hurudisha matokeo yaleyale. Vigezo vya lazima: session_id (query), visitor_id (query). Hali za hitilafu zilizoandikwa: 400 PARAMS_REQUIRED. Jibu la mfano hapa chini linaonyesha muundo wa jibu lililofanikiwa katika umbizo la JSON.
Uthibitishaji na ulinzi
Hakuna uthibitishaji unaohitajika
Idempotent: Ndiyo
Vigezo
session_id(query, string, inahitajika)— ID ya kipindi cha mazungumzo ya demovisitor_id(query, string, inahitajika)— ID ya mgeni (UUID) inayotengenezwa na ukurasa wa demoMfano wa jibu (response)
{"ok":true,"data":{"messages":[{"id":"f248d929-c9ce-412d-aba8-43808ca1c9f7","role":"user","text":"Habari, Zentor inagharimu kiasi gani?","created_at":"2026-07-20T17:07:02.240Z"},{"id":"3c26b6a6-4ca6-47a9-9669-a052082007ac","role":"assistant","text":"Ninaweza kukuonyesha jinsi hili lingeonekana kwa matumizi yako — bila wajibu wowote.","created_at":"2026-07-20T17:07:02.329Z"}]}}Misimbo ya hitilafu
400 PARAMS_REQUIRED — `session_id` au `visitor_id` haipo.Tabia iliyoangaliwa
Kipindi cha demo kilichopo hutoa 200 na historia; vigezo vinavyokosekana hutoa 400 `PARAMS_REQUIRED`.
Chatbot ya demo na SSO
POST /api/global-chatbot/demoHutuma ujumbe kwa boti ya onyesho ya umma kwenye zentor-app.de/demo na hutoa jibu lake. Onyesho linaweza kujaribiwa bila kujisajili kwenye kivinjari.POST /api/global-chatbot/demo/pollHupata ujumbe mpya wa mazungumzo ya onyesho, kwa mfano wakati mfanyakazi wa Zentor amechukua mazungumzo. Ukurasa wa onyesho huita kituo kwa vipindi.POST /api/global-chatbot/demo/ratingHuhifadhi tathmini ya mazungumzo ya onyesho (ya manufaa au si ya manufaa) na maoni ya hiari.POST /api/global-chatbot/demo/trackHurekodi matukio ya matumizi yasiyojulikana ya ukurasa wa onyesho kwa takwimu za wageni wa Zentor.POST /api/global-chatbot/demo/voice-transcribeHubadilisha rekodi ya sauti kwenye ukurasa wa onyesho kuwa maandishi (ingizo la sauti), ikiwa kipengele cha sauti cha onyesho kimewezeshwa.POST /api/global-chatbot/demo/voice-speakHubadilisha maandishi kuwa sauti inayosemwa (matamshi kwenye ukurasa wa demo), ikiwa kipengele cha sauti cha demo kimewezeshwa.GET /api/sso/:tenantSlug/statusHuangalia kama kuingia mara moja (SAML au OIDC) kumewekwa kwa akaunti. Ukurasa wa kuingia hutumia matokeo kutoa kuingia kwa SSO.GET /api/sso/:tenantSlug/oidc/startHuanzisha kuingia kupitia OpenID Connect na kuelekeza kivinjari kwa mtoa huduma wa utambulisho aliyewekwa.GET /api/sso/:tenantSlug/oidc/callbackHupokea uelekezaji wa mtoa huduma wa utambulisho baada ya kuingia kwa OIDC na kurudisha kivinjari kwa Zentor App.GET /api/sso/:tenantSlug/saml/startHuanzisha kuingia kupitia SAML na kuelekeza kivinjari kwa mtoa huduma wa utambulisho aliyewekwa.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): hupokea jibu la SAML lililotiwa saini kutoka mtoa huduma wa utambulisho kwa fomu ya POST.GET /api/sso/:tenantSlug/saml/metadataHutoa metadata ya SAML ya Zentor App (XML) kwa kuingiza kwenye mtoa huduma wenu wa utambulisho.