GET/api/global-chatbot/demo/history

Laadt de bestaande berichtgeschiedenis van een demogesprek, zodat deze behouden blijft bij het opnieuw openen van de demo.

Geef `session_id` en `visitor_id` door als queryparameters; beide moeten uit hetzelfde demogesprek komen. In het object `data` bevat het antwoord de lijst `messages` met `id`, `role`, `text` en `created_at`. De aanroep is alleen-lezen en idempotent. Ontbreekt een van de parameters, dan antwoordt de server met 400 `PARAMS_REQUIRED`. Is de sessie niet meer bekend, start dan een nieuw demogesprek.

Overzicht

Aanroep: GET /api/global-chatbot/demo/history. Dit endpoint hoort bij de groep ‘Demo-chatbot en SSO’ van de API van Zentor App. Het is openbaar toegankelijk en vereist geen authenticatie. De aanroep is idempotent: herhaalde aanroepen met dezelfde gegevens leveren hetzelfde resultaat op. Verplichte parameters: session_id (query), visitor_id (query). Gedocumenteerde foutgevallen: 400 PARAMS_REQUIRED. Het voorbeeldantwoord hieronder toont de opbouw van een geslaagd antwoord in JSON-formaat.

Auth & beveiliging

Geen authenticatie vereist

Idempotent: Ja

Parameters

session_id(query, string, vereist)— Sessie-ID van het demogesprek
visitor_id(query, string, vereist)— Bezoeker-ID (UUID) gegenereerd door de demopagina

Voorbeeld-response

{"ok":true,"data":{"messages":[{"id":"f248d929-c9ce-412d-aba8-43808ca1c9f7","role":"user","text":"Hallo, wat kost Zentor?","created_at":"2026-07-20T17:07:02.240Z"},{"id":"3c26b6a6-4ca6-47a9-9669-a052082007ac","role":"assistant","text":"Ik kan je laten zien hoe dit eruit zou zien voor jouw gebruikssituatie — zonder verplichtingen.","created_at":"2026-07-20T17:07:02.329Z"}]}}

Foutcodes

400 PARAMS_REQUIRED — `session_id` of `visitor_id` ontbreekt.

Geverifieerd gedrag

Een bestaande demosessie levert 200 met de geschiedenis; ontbrekende parameters leveren 400 `PARAMS_REQUIRED`.

Demo-chatbot en SSO

POST /api/global-chatbot/demoVerzendt een bericht naar de openbare demo-chatbot op zentor-app.de/demo en levert het antwoord daarvan. De demo kan zonder registratie in de browser worden uitgeprobeerd.POST /api/global-chatbot/demo/pollHaalt nieuwe berichten van een demogesprek op, bijvoorbeeld wanneer een medewerker van Zentor het gesprek heeft overgenomen. De demopagina roept het endpoint met tussenpozen aan.POST /api/global-chatbot/demo/ratingSlaat de beoordeling van een demogesprek op (nuttig of niet nuttig) met een optionele opmerking.POST /api/global-chatbot/demo/trackRegistreert anonieme gebruiksgebeurtenissen van de demopagina voor de bezoekersstatistieken van Zentor.POST /api/global-chatbot/demo/voice-transcribeZet een spraakopname op de demopagina om in tekst (spraakinvoer), als de spraakfunctie van de demo is ingeschakeld.POST /api/global-chatbot/demo/voice-speakZet tekst om in gesproken taal (spraakuitvoer op de demopagina), als de spraakfunctie van de demo is ingeschakeld.GET /api/sso/:tenantSlug/statusControleert of single sign-on (SAML of OIDC) is ingericht voor een account. De aanmeldpagina gebruikt het resultaat om de SSO-aanmelding aan te bieden.GET /api/sso/:tenantSlug/oidc/startStart het aanmelden via OpenID Connect en leidt de browser door naar de ingerichte identity provider.GET /api/sso/:tenantSlug/oidc/callbackOntvangt de doorverwijzing van de identity provider na de OIDC-aanmelding en leidt de browser terug naar Zentor App.GET /api/sso/:tenantSlug/saml/startStart het aanmelden via SAML en leidt de browser door naar de ingerichte identity provider.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): ontvangt het ondertekende SAML-antwoord van de identity provider via een formulier-POST.GET /api/sso/:tenantSlug/saml/metadataLevert de SAML-metadata van Zentor App (XML) voor import in uw identity provider.

Gerelateerde artikelen

← Demo-chatbot en SSO