GET/api/global-chatbot/demo/history

Laddar den tidigare meddelandehistoriken för ett demosamtal, så att den bevaras när demon öppnas igen.

Skicka `session_id` och `visitor_id` som frågeparametrar; båda måste komma från samma demosamtal. Svaret innehåller i objektet `data` listan `messages` med `id`, `role`, `text` och `created_at`. Anropet är rent läsande och idempotent. Saknas en av parametrarna, svarar servern med 400 `PARAMS_REQUIRED`. Är sessionen inte längre känd, starta ett nytt demosamtal.

Översikt

Anrop: GET /api/global-chatbot/demo/history. Endpointen tillhör gruppen ”Demo-chattbot och SSO” i Zentor Apps API. Den är offentligt tillgänglig och kräver ingen autentisering. Anropet är idempotent: Upprepade anrop med samma uppgifter ger samma resultat. Obligatoriska parametrar: session_id (query), visitor_id (query). Dokumenterade felfall: 400 PARAMS_REQUIRED. Exempelsvaret nedan visar strukturen för ett lyckat svar i JSON-format.

Autentisering & säkerhet

Ingen autentisering krävs

Idempotent: Ja

Parametrar

session_id(query, string, obligatorisk)— Sessions-ID för demosamtalet
visitor_id(query, string, obligatorisk)— Besökar-ID (UUID) som demosidan genererar

Exempel på response

{"ok":true,"data":{"messages":[{"id":"f248d929-c9ce-412d-aba8-43808ca1c9f7","role":"user","text":"Hej, vad kostar Zentor?","created_at":"2026-07-20T17:07:02.240Z"},{"id":"3c26b6a6-4ca6-47a9-9669-a052082007ac","role":"assistant","text":"Jag kan visa hur det skulle se ut för ditt användningsfall – utan åtagande.","created_at":"2026-07-20T17:07:02.329Z"}]}}

Felkoder

400 PARAMS_REQUIRED — `session_id` eller `visitor_id` saknas.

Verifierat beteende

En befintlig demosession returnerar 200 med historiken; saknade parametrar returnerar 400 `PARAMS_REQUIRED`.

Demo-chattbot och SSO

POST /api/global-chatbot/demoSkickar ett meddelande till den offentliga demo-chattboten på zentor-app.de/demo och returnerar dess svar. Demon kan testas i webbläsaren utan registrering.POST /api/global-chatbot/demo/pollHämtar nya meddelanden från ett demosamtal, till exempel när en Zentor-medarbetare har tagit över samtalet. Demosidan anropar slutpunkten med jämna mellanrum.POST /api/global-chatbot/demo/ratingSparar bedömningen av ett demosamtal (hjälpsamt eller inte hjälpsamt) med valfri kommentar.POST /api/global-chatbot/demo/trackRegistrerar anonyma användningshändelser på demosidan för Zentors besöksstatistik.POST /api/global-chatbot/demo/voice-transcribeOmvandlar en röstinspelning på demosidan till text (röstinmatning), om demons röstfunktion är aktiverad.POST /api/global-chatbot/demo/voice-speakOmvandlar text till tal (röstutmatning på demosidan), om demons röstfunktion är aktiverad.GET /api/sso/:tenantSlug/statusKontrollerar om enkel inloggning (SAML eller OIDC) är konfigurerad för ett konto. Inloggningssidan använder resultatet för att erbjuda SSO-inloggning.GET /api/sso/:tenantSlug/oidc/startStartar inloggning via OpenID Connect och omdirigerar webbläsaren till den konfigurerade identitetsleverantören.GET /api/sso/:tenantSlug/oidc/callbackTar emot identitetsleverantörens omdirigering efter OIDC-inloggning och omdirigerar webbläsaren tillbaka till Zentor App.GET /api/sso/:tenantSlug/saml/startStartar inloggning via SAML och omdirigerar webbläsaren till den konfigurerade identitetsleverantören.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): tar emot identitetsleverantörens signerade SAML-svar via formulär-POST.GET /api/sso/:tenantSlug/saml/metadataReturnerar Zentor Apps SAML-metadata (XML) för import i din identitetsleverantör.

Relaterade artiklar

← Demo-chattbot och SSO