Skip to main content
Versión: utilizar siempre la última versión disponible
Este agente te permite verificar la identidad de una persona sin sacarla del chat, combinando video selfie en tiempo real (prueba de vida), captura de documento y comparación facial automática (1:1).
Ideal para onboarding, acceso, firma electrónica o validaciones de alto riesgo.

Requisitos previos

✅ Checklist para iniciar sin bloqueos

  • Debes contar con el PDF de Términos y Condiciones (URL pública) para configurarlo en el agente. Esto es obligatorio.
  • 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).

¿Cómo funciona?

En menos de 1 minuto, el usuario completa los dos primeros pasos:
1

Grabar un video selfie

El usuario graba un video corto en tiempo real, siguiendo instrucciones simples dentro del chat.
2

Capturar fotos de su documento de identidad

Se solicitan fotos frontal y reverso del documento de identidad, para validar vigencia y autenticidad.
3

Comparación facial automática

El sistema aplica la técnica 1:1, comparando un frame del video con la imagen del documento (o con la fuente gubernamental oficial si está habilitada).

¿Cómo está compuesto el Agente?

El Agente de Biometría está compuesto por tres agentes especializados:
  1. Agente prueba de vida - Validación de liveness mediante video-selfie con OTP
  2. Agente verificación de Documento - Verificación de autenticidad y vigencia del documento
  3. Agente comparación facial - Comparación facial 1:1 entre el video y el documento/entidad gubernamental
Si necesitas implementar solo una parte del proceso (por ejemplo, solo documento), revisa la configuración en Agentes por etapa.

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

Conecta la integración

Busca KYC y verás el detalle de la integración, incluido precios, un feature de pruebas y disponibilidad por país. Para hacer uso del free trial, da clic en “Conectar”. Al conectarlo, se abrirá el canvas de trabajo en Brain para que puedas configurarlo y usarlo.
3

Configuración inicial

  • Para utilizar la validación con video, selecciona “Biometría vivacidad pasiva”
  • Lo primero que debes configurar es la versión que se encuentra en “Configuración avanzada” (al final).
  • Ninguno de los inputs (excepto el PDF) requiere cambios si usarás los valores por defecto. Si requieres cambiarlo puedes ingresarlo en el campo correspondiente.
  • Si deseas modificar algún input, ve a la sección Configuración.
4

Configurar Outputs

Este agente cuenta con 8 outputs de error y 1 de success. Cada uno de ellos puedes dirigirlo a:
  • Input de texto con mensaje personalizado.
  • Connect, solo si cuentas con este módulo.
5

Realizar pruebas

Con la configuración que acabas de realizar, puedes proceder a realizar las pruebas utilizando como precursor un skill u otro agente.
Importante: El campo “PDF Términos y Condiciones” es obligatorio. El documento debe incluir de forma explícita el uso, almacenamiento y tratamiento de datos personales y biométricos. Debe presentarse y aceptarse antes de iniciar el proceso de verificación.

Configuración

Idioma
string
default:"Es"
Variable: language. Permite definir el idioma de la experiencia.Valores disponibles: Es (Español), En (Inglés)
Cantidad máxima intentos Biometría
number
default:"2"
Variable: maxBiometricAttempts. Cantidad máxima de intentos de la Biometría. Valores disponibles: 1-4
Email notificación reintentos excedidos
string
Variable: customerServiceEmail. Correo al que se notificará cuando se supere la cantidad máxima de intentos.
PDF Términos y condiciones (obligatorio)
string
Variable: termsAndConditionsPdf. URL pública del PDF de Términos y condiciones.Debe detallar explícitamente el manejo de datos personales, incluyendo el uso, almacenamiento y tratamiento de información biométrica.
Debe mostrarse al usuario antes de iniciar el proceso.
Habilitar Video de Introducción Prueba de Vida
boolean
default:"false"
Variable: enableIntroVideo. Determina si se debe mostrar un video de introducción al usuario antes de comenzar el proceso.
URL para mostrar media de Introducción Prueba de Vida
string
Variable: introMediaUrl. URL que se muestra al usuario para cargar un video o imagen de introducción.
Duración máxima código OTP
number
default:"1"
Variable: otpDuration. Duración máxima en minutos del código OTP.Valores disponibles: 1-10
Longitud código OTP en Chat
number
default:"4"
Variable: otpLength. Cantidad de dígitos del código OTP.Valores disponibles: 3-6
Verificar fecha de expiración del documento
string
default:"Desactivado"
Variable: dateExpiracyCheck. Verifica la fecha de expiración del documento.Valores disponibles: Desactivado, Activado
Habilitar validación gubernamental
boolean
default:"false"
Variable: flagGovValidation. Habilita validación gubernamental; en false no se consulta al registro civil.
Umbral aceptado en comparación facial
number
default:"60"
Variable: facematchThreshold. Porcentaje mínimo requerido en facematch.Valores disponibles: 55-95
Habilitar Human in the loop
boolean
default:"false"
Variable: enableHumanInLoop. Indica si se activa el proceso de revisión con un asesor humano.
Habilitar LipSync
boolean
default:"false"
Variable: enableLipSync. Habilita LipSync para comparar 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 (en horas)
number
default:"2"
Variable: blockingInHours. Tiempo de bloqueo (en horas) tras exceder intentos.Valores disponibles: número entero (por ejemplo: 2, 24, 168)

Reporte

Por defecto se crea una base de datos llamada “Reporte Agente de Biometría” con los siguientes campos:
CampoDescripción
Código de BiometríaIdentificador único del proceso
Fecha y HoraTimestamp de la verificación
Resultado BiometríaEstado final del proceso
Número de IdentificaciónDocumento del usuario
Tipo de IdentificaciónTipo de documento
NombresNombres del usuario
ApellidosApellidos del usuario
Fecha de NacimientoFecha de nacimiento
CelularTeléfono del usuario
EmailCorreo electrónico
DirecciónDirección del usuario
Resultado Prueba de VidaEstado de la prueba de vida
Video SelfieURL del video
Foto SelfieURL de la foto extraída
Resultado Document CheckEstado de validación del documento
Foto de Documento DelanteraURL de la imagen frontal
Foto de Documento PosteriorURL de la imagen posterior
Foto Rostro en DocumentoURL de la foto del documento
Entidad GubernamentalEntidad consultada
Resultado FacematchPorcentaje de coincidencia facial
Reporte de BiometríaURL del reporte web
Descripción de FalloDetalles del error (si aplica)
ObservacionesNotas adicionales
El reporte biométrico se encuentra disponible para descargarlo en formato PDF, este contiene toda la información detallada en la tabla.

Preguntas frecuentes

Sí, el agente puede responder porque todos los campos tienen valores por defecto. Sin embargo, es obligatorio seleccionar la versión del agente; te recomendamos siempre seleccionar la última versión pública disponible.
Se requieren fotos del documento de identidad por ambos lados: frontal y reverso
No. Este agente está diseñado como un flujo completo: video selfie + documento + facematch. Si necesitas solo una parte (por ejemplo, solo documento), debes instalar los agentes por etapa.
Sí, puedes modificar los textos de interacción. Si necesitas agregar preguntas, condicionales u otras personalizaciones avanzadas, te sugerimos consultar con el equipo de Jelou.
No. El PDF de Términos y Condiciones es obligatorio para usar este agente.
Si expira el OTP, el proceso completo expira y el usuario debe reiniciar. Si el usuario abandona el flujo, el proceso queda no finalizado y expira según la lógica del agente/experiencia.
Depende de tu configuración:
  • Cantidad máxima intentos Biometría (maxBiometricAttempts): controla intentos de biometría.
  • Cant. máxima intentos del Agente (retriesAgent): controla reintentos del agente antes de bloquear.
  • Tiempo de Bloqueo del usuario (blockingInHours): define cuántas horas dura el bloqueo.