POST/api/global-chatbot/demo/voice-speak
Convierte texto en voz (salida de voz en la página de demostración), si la función de voz de la demo está activada.
Envíe `visitor_id` (UUID) y el texto a leer en `text`. La respuesta contiene los datos de audio para la reproducción; para un elemento `<audio>`, la misma ruta también está disponible mediante GET. El endpoint corresponde a `POST /api/public/widget/voice-speak`, pero está vinculado a la demo en zentor-app.de y no está pensado como una interfaz general de texto a voz. Casos de error: 400 `INVALID_VISITOR_ID` (UUID ausente o no válido), 403 `ORIGIN_DENIED` (llamada no procedente de zentor-app.de) y 503 `VOICE_UNAVAILABLE` (función de voz actualmente no disponible).
Descripción general
Llamada: POST /api/global-chatbot/demo/voice-speak. 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: visitor_id (body), text (body). Casos de error documentados: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE. La respuesta de ejemplo siguiente muestra la estructura de una respuesta correcta en formato JSON.
Autenticación y seguridad
No se requiere autenticación
Solo acepta llamadas de https://zentor-app.de y https://www.zentor-app.de; no se requiere token de inserción para la demo.
Idempotente: Sí
Parámetros
visitor_id(body, string, obligatorio)— ID de visitante, debe ser un UUID válidotext(body, string, obligatorio)— Texto que se va a leer en voz altaRespuesta de ejemplo
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}Códigos de error
400 INVALID_VISITOR_ID — `visitor_id` falta o no es un UUID válido.403 ORIGIN_DENIED — La llamada no procede de zentor-app.de.503 VOICE_UNAVAILABLE — La función de voz no está disponible actualmente.Comportamiento verificado
Un `visitor_id` no válido devuelve 400 `INVALID_VISITOR_ID`, una función de voz no disponible devuelve 503 `VOICE_UNAVAILABLE`. El caso de éxito solo es posible desde zentor-app.de.
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.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.