GET/api/global-chatbot/demo/history

Carga el historial de mensajes de una conversación de demostración para que se conserve al volver a abrir la demo.

Transmita `session_id` y `visitor_id` como parámetros de consulta; ambos deben provenir de la misma conversación de demostración. En el objeto `data`, la respuesta contiene la lista `messages` con `id`, `role`, `text` y `created_at`. La llamada es de solo lectura e idempotente. Si falta alguno de los parámetros, el servidor responde con 400 `PARAMS_REQUIRED`. Si la sesión ya no se conoce, inicie una nueva conversación de demostración.

Descripción general

Llamada: GET /api/global-chatbot/demo/history. Este endpoint pertenece al grupo «Chatbot de demostración y SSO» de la API de Zentor App. Es de acceso público y no requiere autenticación. La llamada es idempotente: las llamadas repetidas con los mismos datos devuelven el mismo resultado. Parámetros obligatorios: session_id (query), visitor_id (query). Casos de error documentados: 400 PARAMS_REQUIRED. La respuesta de ejemplo siguiente muestra la estructura de una respuesta correcta en formato JSON.

Autenticación y seguridad

No se requiere autenticación

Idempotente: Sí

Parámetros

session_id(query, string, obligatorio)— ID de sesión de la conversación de demostración
visitor_id(query, string, obligatorio)— ID de visitante (UUID) generado por la página de demostración

Respuesta de ejemplo

{"ok":true,"data":{"messages":[{"id":"f248d929-c9ce-412d-aba8-43808ca1c9f7","role":"user","text":"Hola, ¿cuánto cuesta Zentor?","created_at":"2026-07-20T17:07:02.240Z"},{"id":"3c26b6a6-4ca6-47a9-9669-a052082007ac","role":"assistant","text":"Puedo mostrarle cómo sería para su caso de uso, sin compromiso.","created_at":"2026-07-20T17:07:02.329Z"}]}}

Códigos de error

400 PARAMS_REQUIRED — Falta `session_id` o `visitor_id`.

Comportamiento verificado

Una sesión de demostración existente devuelve 200 con el historial; los parámetros ausentes devuelven 400 `PARAMS_REQUIRED`.

Chatbot de demostración y SSO

POST /api/global-chatbot/demoEnvía un mensaje al chatbot de demostración público en zentor-app.de/demo y devuelve su respuesta. La demo se puede probar en el navegador sin registrarse.POST /api/global-chatbot/demo/pollObtiene los nuevos mensajes de una conversación de demostración, por ejemplo cuando un empleado de Zentor ha tomado el relevo de la conversación. La página de demostración llama al endpoint a intervalos.POST /api/global-chatbot/demo/ratingGuarda la valoración de una conversación de demostración (útil o no útil) con un comentario opcional.POST /api/global-chatbot/demo/trackRegistra eventos de uso anónimos de la página de demostración para las estadísticas de visitantes de Zentor.POST /api/global-chatbot/demo/voice-transcribeConvierte una grabación de voz en la página de demostración en texto (entrada de voz), si la función de voz de la demo está activada.POST /api/global-chatbot/demo/voice-speakConvierte texto en voz (salida de voz en la página de demostración), si la función de voz de la demo está activada.GET /api/sso/:tenantSlug/statusComprueba si el inicio de sesión único (SAML u OIDC) está configurado para una cuenta. La página de inicio de sesión utiliza el resultado para ofrecer el inicio de sesión SSO.GET /api/sso/:tenantSlug/oidc/startInicia el inicio de sesión mediante OpenID Connect y redirige el navegador al proveedor de identidad configurado.GET /api/sso/:tenantSlug/oidc/callbackRecibe la redirección del proveedor de identidad después del inicio de sesión OIDC y redirige el navegador de vuelta a Zentor App.GET /api/sso/:tenantSlug/saml/startInicia el inicio de sesión mediante SAML y redirige el navegador al proveedor de identidad configurado.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): recibe la respuesta SAML firmada del proveedor de identidad mediante un POST de formulario.GET /api/sso/:tenantSlug/saml/metadataDevuelve los metadatos SAML de Zentor App (XML) para su importación en su proveedor de identidad.

Artículos relacionados

← Chatbot de demostración y SSO