GET/api/sso/:tenantSlug/saml/metadata
Devuelve los metadatos SAML de Zentor App (XML) para su importación en su proveedor de identidad.
Los metadatos contienen, entre otras cosas, el ID de entidad y la URL de ACS que su proveedor de identidad necesita para la configuración. La respuesta es un documento XML, no JSON. Si SAML no está configurado para la cuenta, el servidor responde con 404 `SSO_NOT_CONFIGURED`.
Descripción general
Llamada: GET /api/sso/:tenantSlug/saml/metadata. 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
(metadatos SAML como documento XML si SAML está configurado para la cuenta – no JSON)
Códigos de error
404 - — SAML no está configurado para esta cuenta.Comportamiento verificado
Para una cuenta sin SAML, la solicitud 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.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.