Skip to main content
Versión: utilizar siempre la última versión disponible
Este agente te permite ejecutar una verificación de identidad completa dentro de WhatsApp Flows, combinando prueba de vida por foto, validación de documento y comparación facial.
Este agente bloquea el uso de documentos desde galería o documentos, evitando fraudes.

Requisitos previos

✅ Checklist para iniciar sin bloqueos

  • Debes tener una cuenta verificada en WhatsApp.
  • 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 tomar foto 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 siguientes pasos:
1

Tomar una foto de su rostro

Utilizando la cámara frontal, el usuario toma una foto de su rostro. Se bloquea el acceso a la galería de fotos o documentos.
2

Capturar fotos de su documento de identidad

Se solicitan fotos frontal y reverso del documento de identidad, para validar vigencia y autenticidad. Se bloquea el acceso a la galería de fotos o documentos.
3

Comparación facial automática

El sistema aplica la técnica 1:1, comparando la foto con la imagen del documento (o con la fuente gubernamental oficial si está habilitada).
La configuración de thresholds, expiración y manejo de errores depende de cada etapa del flujo.

¿Cómo se compone el agente?

El Agente de Biometría (Flows) se compone de tres agentes especializados:
  1. Agente prueba de vida con WhatsApp Flows - Valida la vivacidad de la persona mediante foto: confirma que haya un único rostro, detecta recapturas y evalúa señales de intento de fraude.
  2. Agente verificación de Documento - Verifica la autenticidad y vigencia del documento, detecta recapturas y evalúa señales de intento de fraude.
  3. Agente comparación facial - Comparación facial 1:1 entre la foto y el rostro del documento/entidad gubernamental. Como resultado entrega un porcentaje de coincidencia y estado binario (aprobado/desaprobado) según el umbral configurado.
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

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 biometría flows.
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 biometría flows y haz clic para abrirlo: el nodo se cargará en tu canvas.
5

Configuración inicial

  • Haz clic en el nodo, abre Configuración avanzada (al final) y selecciona la versión del agente.
  • 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, configúralos en la barra lateral.
6

Configurar Outputs

Este Agente cuenta con 10 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.
7

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

Cantidad máxima intentos Biometría
number
default:"2"
Variable: maxBiometricAttempts. Valores disponibles: 1-4
Email notificación reintentos excedidos
string
Variable: customerServiceEmail. Correo de alerta cuando se superan intentos.
Umbral aceptado en comparación facial
number
default:"60"
Variable: facematchThreshold. Valores disponibles: 55-95 Porcentaje mínimo de aprobación en comparación facial.
Verificar fecha de expiración
string
default:"false"
Variable: dateExpiracyCheck. Valores disponibles: false, true Activa control de vigencia del documento.
Habilitar validación gubernamental
boolean
default:"false"
Variable: flagGovValidation. Valores disponibles: false, true Define si se consulta fuente oficial.
Habilitar validación gubernamental
boolean
default:"false"
Valores disponibles: false, true Setear “true” para cargar la URL de los términos y condiciones
PDF términos y condiciones (obligatorio)
string (URL)
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 Human in the loop
boolean
default:"false"
Variable: enableHumanInLoop. Valores disponibles: false, true Indica si se activa el proceso de revisión con un asesor humano. Servicio add-on con pago adicional
Editar imágenes de flow
boolean
default:"false"
Variable: validateImage. Valores disponibles: false, true Permite reemplazar imágenes por defecto. Al habilitar la edición, se despligan cinco campos para integrar imágenes personalizadas. El paso a paso para personalizar se encuentra en la sección “Personalización”.

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
Resultado Prueba de VidaEstado de la prueba de vida
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.

Personalización

Puedes personalizar solo las imágenes que aparecen en cada pantalla; el resto del copy del flow no es personalizable.
En las pantallas del flujo, los campos marcados con un cuadro amarillo son personalizables. El resto de los textos no se pueden modificar.
Vista general del flujo de biometría en Flows con recuadros amarillos en los campos personalizables
Vista general del flujo de documento en Flows con recuadros amarillos en las secciones personalizables

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: foto + documento + facematch. Si necesitas solo una parte (por ejemplo, solo documento), debes instalar los agentes por etapa.
No, no puedes modificar los textos de interacción. Puedes agregar mensajes, condicionales y otras personalizaciones en tu skill en canva.
HIL es un servicio add-on con un costo adicional. Cuando está activo, algunos casos pueden pasar a revisión manual (por ejemplo, si no se alcanza el umbral o se agotan los intentos). En este agente, la revisión manual se aplica después de la validación del documento.
  • Cifrado en tránsito y en reposo.
  • Registro de evidencias con hashes para asegurar integridad.
  • Control de acceso con roles (RBAC) y MFA.
Depende de tu configuración:
  • Cantidad máxima intentos Biometría (maxBiometricAttempts): controla intentos de biometría.