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:Tomar una foto de su rostro
Capturar fotos de su documento de identidad
¿Cómo se compone el agente?
El Agente de Biometría (Flows) se compone de tres agentes especializados:- 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.
- Agente verificación de Documento - Verifica la autenticidad y vigencia del documento, detecta recapturas y evalúa señales de intento de fraude.
- 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.
Conexión desde Marketplace
Ingresa a la plataforma
Busca el agente en Marketplace
Haz clic en Developers y usa el buscador para encontrar Agente biometría flows.
Luego haz clic en el ícono de descarga para instalarlo.
Confirma la instalación
Abre el agente en Brain
Busca Agente biometría flows y haz clic para abrirlo: el nodo se cargará en tu canvas.
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.
Configurar Outputs
- Input de texto con mensaje personalizado.
- Connect, solo si cuentas con este módulo.
Configuración
- Inputs
- Outputs
Cantidad máxima intentos biometría
Cantidad máxima intentos biometría
maxBiometricAttempts.
Valores disponibles: 1-4Email notificación reintentos excedidos
Email notificación reintentos excedidos
customerServiceEmail.
Correo de alerta cuando se superan intentos.Umbral aceptado en comparación facial
Umbral aceptado en comparación facial
facematchThreshold.
Valores disponibles: 55-95
Porcentaje mínimo de aprobación en comparación facial.Verificar fecha de expiración del documento
Verificar fecha de expiración del documento
dateExpiracyCheck.
Valores disponibles: false, true
Activa control de vigencia del documento.Habilitar validación gubernamental
Habilitar validación gubernamental
flagGovValidation.
Valores disponibles: false, true
Define si se consulta fuente oficial.Habilitar términos y condiciones
Habilitar términos y condiciones
false, true
Setear “true” para cargar la URL de los términos y condicionesPDF términos y condiciones (obligatorio)
PDF términos y condiciones (obligatorio)
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
Habilitar Human in the loop
enableHumanInLoop.
Valores disponibles: false, true
Indica si se activa el proceso de revisión con un asesor humano. Servicio add-on con pago adicionalEditar imágenes flow
Editar imágenes flow
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:| Campo | Descripción |
|---|---|
| Código de Biometría | Identificador único del proceso |
| Fecha y Hora | Timestamp de la verificación |
| Resultado Biometría | Estado final del proceso |
| Número de Identificación | Documento del usuario |
| Tipo de Identificación | Tipo de documento |
| Nombres | Nombres del usuario |
| Apellidos | Apellidos del usuario |
| Fecha de Nacimiento | Fecha de nacimiento |
| Celular | Teléfono del usuario |
| Correo electrónico | |
| Resultado Prueba de Vida | Estado de la prueba de vida |
| Foto Selfie | URL de la foto extraída |
| Resultado Document Check | Estado de validación del documento |
| Foto de Documento Delantera | URL de la imagen frontal |
| Foto de Documento Posterior | URL de la imagen posterior |
| Foto Rostro en Documento | URL de la foto del documento |
| Entidad Gubernamental | Entidad consultada |
| Resultado Facematch | Porcentaje de coincidencia facial |
| Reporte de Biometría | URL del reporte web |
| Descripción de Fallo | Detalles del error (si aplica) |
| Observaciones | Notas adicionales |
Personalización
Puedes personalizar solo las imágenes que aparecen en cada pantalla; el resto del copy del flow no es personalizable.

Preguntas frecuentes
¿El agente responde si no ingreso datos en ningún campo?
¿El agente responde si no ingreso datos en ningún campo?
¿Qué documentos se necesitan durante el proceso biométrico?
¿Qué documentos se necesitan durante el proceso biométrico?
¿Es posible omitir algún paso en este agente?
¿Es posible omitir algún paso en este agente?
¿Puedo personalizar los textos de este agente?
¿Puedo personalizar los textos de este agente?
¿Qué pasa si habilito “Human in the Loop (HIL)”?
¿Qué pasa si habilito “Human in the Loop (HIL)”?
¿Qué medidas de seguridad aplica este agente?
¿Qué medidas de seguridad aplica este agente?
- Cifrado en tránsito y en reposo.
- Registro de evidencias con hashes para asegurar integridad.
- Control de acceso con roles (RBAC) y MFA.
¿Cuántos intentos tiene el usuario antes de ser bloqueado?
¿Cuántos intentos tiene el usuario antes de ser bloqueado?
- Cantidad máxima intentos Biometría (
maxBiometricAttempts): controla intentos de biometría.