Saltar al contenido principal
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 contar con 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).

¿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

Conecta la integración

Busca KYC y haz clic en Conectar. Si tu organización está en el plan Free, verás el CTA para Subir de plan a Builder (KYC solo está disponible desde el plan Builder en adelante). Si ves el botón Conectar y lo presionas, se abrirá el canvas de trabajo en Brain.
3

Configuración inicial

  • Al arrastrar la integración al canvas y hacer clic, debes seleccionar la tool nativa que deseas utilizar:
    • Conversacional -> Validación con video
    • WebView -> Validación con foto (WebView)
    • Flows -> Validación con foto (Flows)
  • La versión ya se muestra por defecto en su última versión disponible.
  • 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.
4

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

Cantidad máxima intentos Biometría
number
predeterminado:"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
predeterminado:"60"
Variable: facematchThreshold. Valores disponibles: 55-95 Porcentaje mínimo de aprobación en comparación facial.
Verificar fecha de expiración
string
predeterminado:"false"
Variable: dateExpiracyCheck. Valores disponibles: false, true Activa control de vigencia del documento.
Habilitar términos y condiciones
boolean
predeterminado:"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.

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