Skip to main content
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).
Si necesitas implementar solo una parte del proceso (por ejemplo, solo documento), revisa la configuración en Agentes por etapa.

¿Cómo conectar la integración?

Cómo conectar la integración de Biometría

La opción Flows está disponible solo para planes Business y Enterprise.
1

Ingresa a la plataforma

Utiliza el Agente para crear un flujo de biometría, o selecciona el template Validación de identidad. Si quieres iniciar un flujo desde cero, haz clic en Brain Studio en el sidebar.
2

Selecciona Biometría

En la barra de herramientas verás la opción Biometría. Haz clic en Conectar.
3

Conecta la integración

Al conectarla verás el nodo Biometría. En el panel lateral, selecciona Biometría con foto — Flows WhatsApp en el dropdown Selecciona el tipo de biometría.
4

Configurar outputs

Este agente cuenta con 1 output de éxito y 3 de error. Cada uno puedes dirigirlo a:
  • Input de texto con mensaje personalizado.
  • Connect, solo si cuentas con este módulo.
5

Probar

Con la configuración que acabas de realizar, puedes proceder a realizar las pruebas con el botón Probar.
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

Éxito

Confirma que la verificación biométrica fue exitosa.Variable: biometricVerificationSuccessEstructura de respuesta (JSON):
Campos importantes:
  • response_document_check_success: Información del documento de identidad
  • response_liveness_success: Foto enviada para validar la prueba de vida
  • result_facematch: Resultado de la comparación facial
  • reporte_de_biometria: URLs del reporte en formato web y PDF

Errores

La verificación biométrica no pudo completarse.Variables: documentCheckError · livenessErrorDescripción: No se logró validar el documento del usuario, o no se logró detectar la vivacidad del usuario.
El usuario abandonó el proceso antes de completarlo.Variable: userExitProcess
Ha ocurrido un problema con el servicio.Variable: serviceError

Reporte

Por defecto se crea una base de datos llamada “Reporte Agente de Biometría” con los siguientes campos:
El reporte biométrico se encuentra disponible para descargarlo en formato PDF, este contiene toda la información detallada en la tabla.

¿Cómo personalizar la experiencia?

Al hacer clic en el nodo Biometría en el canvas, se abre un panel lateral con las siguientes pestañas de configuración.
Configura la cantidad de reintentos y las opciones de validación de la experiencia completa.
  • Máximo intentos en biometría — define cuántas veces el usuario puede reintentar el proceso completo (1, 2 o 3 intentos).
  • Verificación de fecha de caducidad — activa la validación de vigencia del documento de identidad.
  • Términos y condiciones — habilita la pantalla de aceptación de términos antes de iniciar el proceso.

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