GET/api/global-chatbot/demo/history

Laai die vorige boodskapgeskiedenis van 'n demo-gesprek sodat dit behoue bly wanneer die demo weer oopgemaak word.

Gee `session_id` en `visitor_id` as navraagparameters deur; beide moet uit dieselfde demo-gesprek kom. Die antwoord bevat in die objek `data` die lys `messages` met `id`, `role`, `text` en `created_at`. Die oproep is slegs lesend en idempotent. Ontbreek een van die parameters, antwoord die bediener met 400 `PARAMS_REQUIRED`. Is die sessie nie meer bekend nie, begin 'n nuwe demo-gesprek.

Oorsig

Oproep: GET /api/global-chatbot/demo/history. Hierdie eindpunt behoort tot die groep “Demo-kletsbot en SSO” van die Zentor App-API. Dit is publiek toeganklik en vereis geen verifikasie nie. Die oproep is idempotent: herhaalde oproepe met dieselfde insette lewer dieselfde resultaat. Verpligte parameters: session_id (query), visitor_id (query). Gedokumenteerde foutgevalle: 400 PARAMS_REQUIRED. Die voorbeeldrespons hieronder toon die struktuur van ’n suksesvolle respons in JSON-formaat.

Verifikasie en sekuriteit

Geen verifikasie vereis nie

Idempotent: Ja

Parameters

session_id(query, string, vereis)— Sessie-ID van die demogesprek
visitor_id(query, string, vereis)— Besoeker-ID (UUID) wat die demobladsy genereer

Voorbeeldrespons

{"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 Use Case aussehen könnte — unverbindlich.","created_at":"2026-07-20T17:07:02.329Z"}]}}

Foutkodes

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

Gekontroleerde gedrag

'n Bestaande demosessie lewer 200 met die geskiedenis; ontbrekende parameters lewer 400 `PARAMS_REQUIRED`.

Demo-kletsbot en SSO

POST /api/global-chatbot/demoStuur 'n boodskap aan die openbare demo-kletsbot op zentor-app.de/demo en lewer sy antwoord. Die demo kan sonder registrasie in die blaaier probeer word.POST /api/global-chatbot/demo/pollHaal nuwe boodskappe van 'n demo-gesprek op, byvoorbeeld wanneer 'n personeellid van Zentor die gesprek oorgeneem het. Die demo-blad roep die eindpunt op gereelde tussenposes aan.POST /api/global-chatbot/demo/ratingStoor die beoordeling van 'n demo-gesprek (nuttig of nie nuttig nie) met opsionele kommentaar.POST /api/global-chatbot/demo/trackRegistreer anonieme gebruiksgebeure van die demo-blad vir Zentor se besoekerstatistieke.POST /api/global-chatbot/demo/voice-transcribeOmskep 'n klankopname op die demo-blad na teks (spraakinvoer), indien die spraakfunksie van die demo geaktiveer is.POST /api/global-chatbot/demo/voice-speakVerander teks in gesproke taal (spraakuitvoer op die demobladsy), mits die spraakfunksie van die demo geaktiveer is.GET /api/sso/:tenantSlug/statusKyk of enkelaanmelding (SAML of OIDC) vir 'n rekening opgestel is. Die aanmeldbladsy gebruik die resultaat om die SSO-aanmelding aan te bied.GET /api/sso/:tenantSlug/oidc/startBegin die aanmelding per OpenID Connect en stuur die blaaier deur na die opgestelde identiteitsverskaffer.GET /api/sso/:tenantSlug/oidc/callbackNeem die omleiding van die identiteitsverskaffer ná die OIDC-aanmelding in ontvangs en stuur die blaaier terug na Zentor App.GET /api/sso/:tenantSlug/saml/startBegin die aanmelding per SAML en stuur die blaaier deur na die opgestelde identiteitsverskaffer.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): neem die ondertekende SAML-antwoord van die identiteitsverskaffer per vorm-POST in ontvangs.GET /api/sso/:tenantSlug/saml/metadataLewer die SAML-metadata van Zentor App (XML) vir invoer in u identiteitsverskaffer.

Verwante artikels

← Demo-kletsbot en SSO