GET/api/global-chatbot/demo/history
Laster inn den tidligere meldingshistorikken til en demosamtale, slik at den bevares når demoen åpnes på nytt.
Overfør `session_id` og `visitor_id` som forespørselsparametre; begge må komme fra samme demosamtale. Svaret inneholder i objektet `data` listen `messages` med `id`, `role`, `text` og `created_at`. Kallet er rent lesende og idempotent. Mangler en av parametrene, svarer serveren med 400 `PARAMS_REQUIRED`. Er sesjonen ikke lenger kjent, start en ny demosamtale.
Oversikt
Kall: GET /api/global-chatbot/demo/history. Endepunktet tilhører gruppen «Demo-chatbot og SSO» i API-et til Zentor App. Det er offentlig tilgjengelig og krever ingen autentisering. Kallet er idempotent: Gjentatte kall med de samme opplysningene gir samme resultat. Obligatoriske parametere: session_id (query), visitor_id (query). Dokumenterte feiltilfeller: 400 PARAMS_REQUIRED. Eksempelsvaret nedenfor viser strukturen til et vellykket svar i JSON-format.
Autentisering og sikring
Ingen autentisering påkrevd
Idempotent: Ja
Parametere
session_id(query, string, påkrevd)— Sesjons-ID for demosamtalenvisitor_id(query, string, påkrevd)— Besøkende-ID (UUID) som demosiden generererEksempel på svar
{"ok":true,"data":{"messages":[{"id":"f248d929-c9ce-412d-aba8-43808ca1c9f7","role":"user","text":"Hei, hva koster Zentor?","created_at":"2026-07-20T17:07:02.240Z"},{"id":"3c26b6a6-4ca6-47a9-9669-a052082007ac","role":"assistant","text":"Jeg kan vise deg hvordan det ville sett ut for ditt bruksområde – uten forpliktelser.","created_at":"2026-07-20T17:07:02.329Z"}]}}Feilkoder
400 PARAMS_REQUIRED — `session_id` eller `visitor_id` mangler.Verifisert oppførsel
En eksisterende demosesjon returnerer 200 med historikken; manglende parametre returnerer 400 `PARAMS_REQUIRED`.
Demo-chatbot og SSO
POST /api/global-chatbot/demoSender en melding til den offentlige demo-chatboten på zentor-app.de/demo og returnerer svaret. Demoen kan prøves i nettleseren uten registrering.POST /api/global-chatbot/demo/pollHenter nye meldinger fra en demosamtale, for eksempel når en Zentor-ansatt har overtatt samtalen. Demosiden kaller endepunktet med jevne mellomrom.POST /api/global-chatbot/demo/ratingLagrer vurderingen av en demosamtale (nyttig eller ikke nyttig) med valgfri kommentar.POST /api/global-chatbot/demo/trackRegistrerer anonyme brukshendelser på demosiden for Zentors besøksstatistikk.POST /api/global-chatbot/demo/voice-transcribeKonverterer en taleopptak på demosiden til tekst (taleinnmating), hvis demoens talefunksjon er aktivert.POST /api/global-chatbot/demo/voice-speakKonverterer tekst til tale (taleutgang på demosiden), hvis demoens talefunksjon er aktivert.GET /api/sso/:tenantSlug/statusKontrollerer om enkelt pålogging (SAML eller OIDC) er satt opp for en konto. Innloggingssiden bruker resultatet til å tilby SSO-innlogging.GET /api/sso/:tenantSlug/oidc/startStarter innlogging via OpenID Connect og omdirigerer nettleseren til den oppsatte identitetsleverandøren.GET /api/sso/:tenantSlug/oidc/callbackMottar identitetsleverandørens omdirigering etter OIDC-innlogging og omdirigerer nettleseren tilbake til Zentor App.GET /api/sso/:tenantSlug/saml/startStarter innlogging via SAML og omdirigerer nettleseren til den oppsatte identitetsleverandøren.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): Mottar identitetsleverandørens signerte SAML-svar via formular-POST.GET /api/sso/:tenantSlug/saml/metadataReturnerer Zentor Apps SAML-metadata (XML) for import i identitetsleverandøren din.