GET/api/sso/:tenantSlug/saml/start
Inicia el inicio de sesión mediante SAML y redirige el navegador al proveedor de identidad configurado.
Llame al endpoint mediante navegación del navegador. Si SAML está configurado, el servidor responde con una redirección (302) al proveedor de identidad; su respuesta se envía después a `saml/acs`. Si SAML no está configurado para la cuenta, el servidor responde con 404 `SSO_NOT_CONFIGURED` y un mensaje de error JSON.
Descripción general
Llamada: GET /api/sso/:tenantSlug/saml/start. 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: tenantSlug (ruta). Casos de error documentados: 404 -.
Autenticación y seguridad
No se requiere autenticación
Idempotente: Sí
Parámetros
tenantSlug(path, string, obligatorio)— Identificador (slug) de la cuenta para la que SSO está configuradoRespuesta de ejemplo
(redirección 302 al proveedor de identidad si SAML está configurado para la cuenta)
Códigos de error
404 - — SAML no está configurado para esta cuenta.Comportamiento verificado
Para una cuenta sin SAML, la llamada devuelve 404.
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.GET /api/global-chatbot/demo/historyCarga el historial de mensajes de una conversación de demostración para que se conserve al volver a abrir la demo.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.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.