Skip to main content
Versión: utilizar siempre la última versión disponible.
El Agente Prueba de Vida está diseñado para garantizar que la persona detrás de la pantalla es una persona viva y se encuentra presente durante el proceso, sin necesidad de salir del chat. Se recomienda usar este agente cuando solo necesitas validar la vivacidad de una persona. Este agente puede ser usado en cualquier país.
Este no es considerado un proceso biométrico completo.

​
Requisitos previos

​
✅ Checklist para iniciar sin bloqueos

  • El usuario debe poder grabar video desde el chat (los permisos de cámara deben de estar habilitados en el dispositivo).
  • Recomendado: definir el flujo de atención si activas Human in the loop (quién revisa, tiempos, y qué ocurre si no responde).

​
¿Qué pasos realiza el usuario?

1

Leer instrucciones

El usuario ve un mensaje en el chat con los pasos a seguir para grabar un video y una imagen con instrucciones para una grabación adecuada.
2

Grabar un video selfie

El usuario graba un video corto en el cual debe mencionar una secuencia numérica única (OTP).
3

Comunicación constante

El usuario recibe mensajes que indican que su video está siendo analizado: “Estamos verificando tu video. Esto tardará solo unos segundos”. Si el análisis es exitoso, verá “Tu prueba de vida fue exitosa”. Si el análisis presenta errores: “Tuvimos un problema analizando el video. Realiza el proceso nuevamente”.

​
¿Cómo se compone el agente?

El agente contiene tools que analizan el video entregado por el usuario:
  1. Generación de OTP: genera la secuencia numérica que el usuario debe decir al grabar el video.
  2. Speech to text: convierte el audio a texto para comparar si corresponde al código emitido.
  3. Validación de OTP: valida que el código mencionado sea correcto.
  4. Validación de vivacidad pasiva: valida la vivacidad de la imagen extraída del video enviado por el usuario. Este proceso permite identificar y neutralizar deepfakes o cualquier intento de suplantación, garantizando presencia del rostro de una persona viva.
  5. Validación de Lipsync (opcional): valida que el audio del video concuerde con el video, comparando la frecuencia del audio con la del video para confirmar que ambos pertenecen a la misma fuente.
  6. Human in the Loop (solo para enterprise): si el proceso falla, puedes optar por Human in the Loop (HIL), donde el caso será revisado por un operador humano.

​
Conexión desde Marketplace

1

Ingresa a la plataforma

Entra a apps.jelou.ai. En la pantalla de inicio verás Brain Studio y Connect. En Brain Studio, selecciona Marketplace.
2

Busca el agente en Marketplace

En Marketplace verás tres tabs: Catálogo, Instaladas y Developers.
Haz clic en Developers y usa el buscador para encontrar Agente prueba de vida.
Luego haz clic en el ícono de descarga para instalarlo.
3

Confirma la instalación

Si la instalación se completó correctamente, verás el tag Instalada en color verde.
4

Abre el agente en Brain

Ve a Brain. En la barra lateral verás tus skills y tools instaladas.
Busca Agente prueba de vida y haz clic para abrirlo: el flujo se cargará en tu canvas.
5

Configura la versión e inputs

Haz clic en el nodo input, abre Configuración avanzada (al final) y selecciona la versión del agente.
Si usarás valores por defecto, no necesitas modificar inputs.
Si vas a cambiar algún input o personalizar mensajes, revisa la sección Configuración.
6

Configura los outputs

Este agente tiene 5 outputs de error y 1 output de éxito.
Puedes dirigir cada output a:
  • Un input de texto con un mensaje personalizado.
  • Connect (solo si tu organización tiene este módulo).
7

Realiza pruebas

Con la configuración lista, ejecuta pruebas usando un skill o un agente previo como “precursor” para disparar el flujo.

​
Configuración

​
Idioma
string
default:"Es"
Variable: language. Permite definir el idioma de la experiencia.Valores disponibles: Es (Español), En (Inglés)
​
Cant. máxima intentos en prueba de vida
number
default:"3"
Variable: retries. Cantidad máxima de intentos de la prueba de vida.Valores disponibles: 1-5
​
Email notificación reintentos excedidos
string
Variable: customerServiceEmail. Correo al que se notificará cuando se supere la cantidad máxima de intentos.
​
Habilitar Video de Introducción Prueba de Vida
boolean
default:"false"
Variable: enableIntroVideo. Determina si se debe mostrar el video de introducción al usuario antes de comenzar el proceso.
​
URL para mostrar media de Introducción Prueba de Vida
string
Variable: introMediaUrl. Es la URL proporcionada al usuario para cargar un video o imagen de introducción que será utilizada en el proceso.
​
Longitud código OTP en Chat
number
default:"4"
Variable: otpLength. Cantidad de dígitos en el código OTP.Valores disponibles: 3-6
​
Duración máxima código OTP
number
default:"1"
Variable: otpDuration. Duración máxima de tiempo código OTP, en minutos.Valores disponibles: 1-10
​
Habilitar Human in the loop
boolean
default:"false"
Variable: enableHumanInLoop. Esta variable indica si el proceso de revisión con un asesor humano debe activarse.
​
Habilitar LipSync
boolean
default:"false"
Variable: enableLipSync. Habilitar LipSync para la comparación de labios con el audio.
​
Cant. máxima intentos del Agente
string
default:"Indefinida"
Variable: retriesAgent. Cantidad máxima de intentos del Agente para bloquear al usuario.Valores disponibles: Indefinida, 1, 2, 3
​
Tiempo de Bloqueo del usuario
string
default:"1 dia"
Variable: blockingInHours. Tiempo de bloqueo cuando excede el número de intentos del Agente.Valores disponibles: 1 dia, 1 semana, 1 mes
​
Habilitar mensajes personalizados
boolean
default:"false"
Variable: enableCustomMessages. Habilitar mensajes personalizados.
Variable: speechToTextMessages. Mensajes personalizados para errores de transcripción de audio.Formato JSON:
{
  "no_text": {
    "description": "Cuando tomaste el video-selfie no logramos capturar el sonido de tu voz. Quizás te encuentres en un lugar muy ruidoso, o enviaste un video sin sonido.",
    "advice": "Intenta nuevamente, asegurando que el video-selfie tenga sonido."
  },
  "error_http": {
    "description": "Lo sentimos, hubo un error en la transcripción del audio.",
    "advice": "Intenta nuevamente, asegurando que el video-selfie tenga sonido."
  },
  "error_code": {
    "description": "Lo sentimos, hubo un error en la transcripción del audio.",
    "advice": "Intenta nuevamente, asegurando que el video-selfie tenga sonido."
  }
}
Variable: OTPValidationMessages. Mensajes personalizados para errores de validación OTP.Formato JSON:
{
  "client_error": {
    "description": "⚠️ La secuencia numérica que mencionaste es *[transcription]*, y no es la correcta.",
    "advice": "Intenta nuevamente, asegurando que la secuencia numérica sea correcta."
  },
  "OTP_ERROR": {
    "description": "⚠️ Lo sentimos, excediste el tiempo límite para que podamos validar tu video-selfie.",
    "advice": "Intenta nuevamente, asegurando que la secuencia numérica sea correcta."
  },
  "CODE_ERROR": {
    "description": "Lo sentimos, ocurrió un error inesperado en el servicio.",
    "advice": "Intenta nuevamente, asegurando que la secuencia numérica sea correcta."
  },
  "HTTP_ERROR": {
    "description": "Lo sentimos, ocurrió un error inesperado en el servicio.",
    "advice": "Intenta nuevamente, asegurando que la secuencia numérica sea correcta."
  }
}
Variable: passiveLivenessMessages. Mensajes personalizados para errores de vivacidad pasiva.Formato JSON:
{
  "resp_face": {
    "description": "¡Lo sentimos! Analizamos tu video y *no pudimos detectar ningún rostro*.",
    "advice": "Intenta nuevamente, asegurando que el video-selfie tenga un rostro visible."
  },
  "mas_de_un_rostro": {
    "description": "¡Lo sentimos! Analizamos tu video y *detectamos más de un rostro*.",
    "advice": "Intenta nuevamente, asegurando que el video-selfie tenga un solo rostro visible."
  },
  "rostro_lejos": {
    "description": "¡Lo sentimos! Analizamos tu video y encontramos que *tu cara estaba un poco lejos de la cámara*.",
    "advice": "Intenta nuevamente, asegurando que el video-selfie tenga la cara a la cámara."
  },
  "rostro_cerca": {
    "description": "¡Lo sentimos! Analizamos tu video y al parecer *acercaste mucho tu cara a la cámara y no se logró capturar una imagen completa*.",
    "advice": "Intenta nuevamente, asegurando que el video-selfie tenga la cara a la cámara."
  },
  "Rostro_cortado_cubierto": {
    "description": "¡Lo sentimos! Analizamos tu video y *parece que estaba cubierto tu rostro o no te encontrabas bien centrado a la cámara*.",
    "advice": "Intenta nuevamente, asegurando que el video-selfie tenga la cara a la cámara."
  },
  "ojos_cerrados": {
    "description": "¡Lo sentimos! Analizamos tu video y no pudimos detectar bien tus ojos, al parecer *te encontrabas con lentes puestos o estabas con tus ojos un poco cerrados*.",
    "advice": "Intenta nuevamente, asegurando que el video-selfie tenga los ojos abiertos."
  },
  "low_quality": {
    "description": "¡Lo sentimos! El video que recibimos tiene baja calidad y no pudimos procesarlo correctamente.",
    "advice": "Intenta nuevamente, asegurando que el video-selfie tenga una calidad adecuada."
  },
  "code_error": {
    "description": "Lo sentimos, ocurrió un error inesperado en el servicio.",
    "advice": "Intenta nuevamente, asegurando que el video-selfie tenga una calidad adecuada."
  },
  "error_http": {
    "description": "Lo sentimos, ocurrió un error inesperado en el servicio.",
    "advice": "Intenta nuevamente, asegurando que el video-selfie tenga una calidad adecuada."
  },
  "error_general": {
    "description": "Lo sentimos, ocurrió un error inesperado en el servicio.",
    "advice": "Intenta nuevamente, asegurando que el video-selfie tenga una calidad adecuada."
  }
}
​
Habilitar instrucciones
boolean
default:"true"
Variable: enableInstructions. Por defecto vienen habilitadas las instrucciones en una imagen.

​
Preguntas frecuentes

No, el proceso de Prueba de vida es tan solo una “etapa” del proceso biométrico, por lo tanto no se considera como biometría facial.
Ninguno, el insumo es únicamente el video-selfie que el usuario se graba con su celular.
Sí, puedes habilitar el video de instrucciones en el input Habilitar Video de Introducción Prueba de Vida (true). Por defecto vienen habilitadas las instrucciones en una imagen.
Sí, puedes añadir tu propio enlace de instrucciones en el input URL para mostrar media de Introducción Prueba de Vida, de esta forma la imagen o video que viene por defecto se deshabilita.
El proceso se cierra cuando transcurrió 1 hora sin actividad en el chat. Si el usuario retorna al chat, debe empezar el flujo desde el inicio.