GET/api/global-chatbot/demo/history

Încarcă istoricul de mesaje al unei conversații demonstrative, astfel încât acesta să fie păstrat la reluarea demo-ului.

Transmiteți `session_id` și `visitor_id` ca parametri de interogare; amândoi trebuie să provină din aceeași conversație demonstrativă. În obiectul `data`, răspunsul conține lista `messages` cu `id`, `role`, `text` și `created_at`. Apelul este doar pentru citire și idempotent. Dacă lipsește unul dintre parametri, serverul răspunde cu 400 `PARAMS_REQUIRED`. Dacă sesiunea nu mai este cunoscută, începeți o nouă conversație demonstrativă.

Prezentare generală

Apel: GET /api/global-chatbot/demo/history. Acest endpoint aparține grupului „Chatbot demonstrativ și SSO” al API-ului Zentor App. Este accesibil public și nu necesită autentificare. Apelul este idempotent: apelurile repetate cu aceleași date returnează același rezultat. Parametri obligatorii: session_id (query), visitor_id (query). Cazuri de eroare documentate: 400 PARAMS_REQUIRED. Răspunsul exemplu de mai jos arată structura unui răspuns reușit în format JSON.

Autentificare și securitate

Nu este necesară autentificarea

Idempotent: Da

Parametri

session_id(query, string, obligatoriu)— ID-ul de sesiune al conversației demonstrative
visitor_id(query, string, obligatoriu)— ID vizitator (UUID) generat de pagina demo

Exemplu de răspuns

{"ok": true, "data": {"messages": [{"id": "f248d929-c9ce-412d-aba8-43808ca1c9f7", "role": "user", "text": "Salut, cât costă Zentor?", "created_at": "2026-07-20T17:07:02.240Z"}, {"id": "3c26b6a6-4ca6-47a9-9669-a052082007ac", "role": "assistant", "text": "Îți pot arăta cum ar arăta pentru cazul tău de utilizare — fără angajament.", "created_at": "2026-07-20T17:07:02.329Z"}]}}

Coduri de eroare

400 PARAMS_REQUIRED — `session_id` sau `visitor_id` lipsește.

Comportament verificat

O sesiune demo existentă returnează 200 cu istoricul; parametrii absenți returnează 400 `PARAMS_REQUIRED`.

Chatbot demonstrativ și SSO

POST /api/global-chatbot/demoTrimite un mesaj către chatbotul demonstrativ public de la zentor-app.de/demo și returnează răspunsul acestuia. Demo-ul poate fi testat în browser fără înregistrare.POST /api/global-chatbot/demo/pollObține mesajele noi ale unei conversații demonstrative, de exemplu atunci când un angajat Zentor a preluat conversația. Pagina demo apelează endpointul la intervale.POST /api/global-chatbot/demo/ratingSalvează evaluarea unei conversații demonstrative (utilă sau neutilă) cu un comentariu opțional.POST /api/global-chatbot/demo/trackÎnregistrează evenimente de utilizare anonime ale paginii demo pentru statisticile de vizitatori ale Zentor.POST /api/global-chatbot/demo/voice-transcribeConvertește o înregistrare vocală de pe pagina demo în text (intrare vocală), dacă funcția vocală a demo-ului este activată.POST /api/global-chatbot/demo/voice-speakConvertește text în vorbire (ieșire vocală pe pagina demo), dacă funcția vocală a demo-ului este activată.GET /api/sso/:tenantSlug/statusVerifică dacă autentificarea unică (SAML sau OIDC) este configurată pentru un cont. Pagina de autentificare folosește rezultatul pentru a oferi autentificarea SSO.GET /api/sso/:tenantSlug/oidc/startPornește autentificarea prin OpenID Connect și redirecționează browserul către furnizorul de identitate configurat.GET /api/sso/:tenantSlug/oidc/callbackPrimește redirecționarea furnizorului de identitate după autentificarea OIDC și redirecționează browserul înapoi la Zentor App.GET /api/sso/:tenantSlug/saml/startPornește autentificarea prin SAML și redirecționează browserul către furnizorul de identitate configurat.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): primește răspunsul SAML semnat al furnizorului de identitate printr-un POST de formular.GET /api/sso/:tenantSlug/saml/metadataReturnează metadatele SAML ale Zentor App (XML) pentru import în furnizorul dumneavoastră de identitate.

Articole similare

← Chatbot demonstrativ și SSO