POST/api/global-chatbot/demo/voice-transcribe

Convierte 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.

Envíe `visitor_id` (UUID) y el archivo de audio en el campo `audio` como `multipart/form-data`. La respuesta contiene el texto reconocido. El endpoint corresponde a `POST /api/public/widget/voice-transcribe`, pero está vinculado a la demo en zentor-app.de. Casos de error: 400 `INVALID_VISITOR_ID` (UUID ausente o no válido), 403 `ORIGIN_DENIED` (llamada no procedente de zentor-app.de), 413 `AUDIO_TOO_LARGE` (archivo demasiado grande) y 415 `AUDIO_TYPE_UNSUPPORTED` (formato no admitido).

Descripción general

Llamada: POST /api/global-chatbot/demo/voice-transcribe. 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 no es idempotente: cada llamada correcta vuelve a desencadenar la acción. Parámetros obligatorios: visitor_id (body), audio (body). Casos de error documentados: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. 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: No

Parámetros

visitor_id(body, string, obligatorio)— ID de visitante, debe ser un UUID válido
audio(body, file, obligatorio)— Archivo de audio (`multipart/form-data`)

Respuesta de ejemplo

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id muss eine gültige UUID sein."}}

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.
413 AUDIO_TOO_LARGE — El archivo de audio supera el tamaño permitido.
415 AUDIO_TYPE_UNSUPPORTED — El formato de audio no es compatible.

Comportamiento verificado

Un `visitor_id` no válido devuelve 400 `INVALID_VISITOR_ID`, una llamada desde otro dominio devuelve 403 `ORIGIN_DENIED`. 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-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