GET/api/global-chatbot/demo/history
Lädt den bisherigen Nachrichtenverlauf einer Demo-Konversation, damit er beim erneuten Öffnen der Demo erhalten bleibt.
Übergeben Sie `session_id` und `visitor_id` als Query-Parameter; beide müssen aus derselben Demo-Konversation stammen. Die Antwort enthält im Objekt `data` die Liste `messages` mit `id`, `role`, `text` und `created_at`. Der Aufruf ist rein lesend und idempotent. Fehlt einer der Parameter, antwortet der Server mit 400 `PARAMS_REQUIRED`. Ist die Sitzung nicht mehr bekannt, beginnen Sie eine neue Demo-Konversation.
Überblick
Aufruf: GET /api/global-chatbot/demo/history. Der Endpunkt gehört zur Gruppe „Demo-Chatbot und SSO“ der API von Zentor App. Er ist öffentlich erreichbar und benötigt keine Authentifizierung. Der Aufruf ist idempotent: Wiederholte Aufrufe mit denselben Angaben liefern dasselbe Ergebnis. Pflichtparameter: session_id (Query), visitor_id (Query). Dokumentierte Fehlerfälle: 400 PARAMS_REQUIRED. Die Beispielantwort unten zeigt den Aufbau einer erfolgreichen Antwort im JSON-Format.
Auth & Absicherung
Keine Authentifizierung erforderlich
Idempotent: Ja
Parameter
session_id(query, string, erforderlich)— Sitzungs-ID der Demo-Konversationvisitor_id(query, string, erforderlich)— Besucher-ID (UUID), die die Demo-Seite erzeugtBeispiel-Response
{"ok":true,"data":{"messages":[{"id":"f248d929-c9ce-412d-aba8-43808ca1c9f7","role":"user","text":"Hallo, was kostet Zentor?","created_at":"2026-07-20T17:07:02.240Z"},{"id":"3c26b6a6-4ca6-47a9-9669-a052082007ac","role":"assistant","text":"Ich kann dir zeigen, wie das für deinen Anwendungsfall aussehen würde — ohne Verpflichtung.","created_at":"2026-07-20T17:07:02.329Z"}]}}Fehlercodes
400 PARAMS_REQUIRED — `session_id` oder `visitor_id` fehlt.Geprüftes Verhalten
Eine bestehende Demo-Sitzung liefert 200 mit dem Verlauf; fehlende Parameter liefern 400 `PARAMS_REQUIRED`.
Demo-Chatbot und SSO
POST /api/global-chatbot/demoSendet eine Nachricht an den öffentlichen Demo-Chatbot auf zentor-app.de/demo und liefert dessen Antwort. Die Demo lässt sich ohne Registrierung im Browser ausprobieren.POST /api/global-chatbot/demo/pollRuft neue Nachrichten einer Demo-Konversation ab, etwa wenn ein Mitarbeiter von Zentor das Gespräch übernommen hat. Die Demo-Seite ruft den Endpunkt in Abständen auf.POST /api/global-chatbot/demo/ratingSpeichert die Bewertung einer Demo-Konversation (hilfreich oder nicht hilfreich) mit optionalem Kommentar.POST /api/global-chatbot/demo/trackErfasst anonyme Nutzungsereignisse der Demo-Seite für die Besucherstatistik von Zentor.POST /api/global-chatbot/demo/voice-transcribeWandelt eine Sprachaufnahme auf der Demo-Seite in Text um (Spracheingabe), sofern die Sprachfunktion der Demo aktiviert ist.POST /api/global-chatbot/demo/voice-speakWandelt Text in gesprochene Sprache um (Sprachausgabe auf der Demo-Seite), sofern die Sprachfunktion der Demo aktiviert ist.GET /api/sso/:tenantSlug/statusPrüft, ob für ein Konto Single Sign-On (SAML oder OIDC) eingerichtet ist. Die Anmeldeseite nutzt das Ergebnis, um die SSO-Anmeldung anzubieten.GET /api/sso/:tenantSlug/oidc/startStartet die Anmeldung per OpenID Connect und leitet den Browser zum eingerichteten Identity-Provider weiter.GET /api/sso/:tenantSlug/oidc/callbackNimmt die Weiterleitung des Identity-Providers nach der OIDC-Anmeldung entgegen und leitet den Browser zurück zu Zentor App.GET /api/sso/:tenantSlug/saml/startStartet die Anmeldung per SAML und leitet den Browser zum eingerichteten Identity-Provider weiter.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): nimmt die signierte SAML-Antwort des Identity-Providers per Formular-POST entgegen.GET /api/sso/:tenantSlug/saml/metadataLiefert die SAML-Metadaten von Zentor App (XML) zum Import in Ihren Identity-Provider.