Saltar al contenido principal
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?

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):
{
  "response_document_check_success": {
    "document_check": {
      "verified_fields": { "...": "Datos principales del documento" },
      "secondary_fields": { "...": "Datos secundarios del documento" },
      "details": { "...": "Detalles del tipo de documento" },
      "image_quality_details": { "...": "Detalles de la calidad de la imagen" },
      "images_extracted": { "...": "Imágenes extraídas del documento" },
      "gov_entity_fields": { "document_number": "Número del documento de identidad" }
    },
    "gov_entity_data": { "...": "Datos de la entidad gubernamental del país" },
    "document_image_front_url": "URL de la imagen frontal del documento",
    "document_image_back_url": "URL de la imagen posterior del documento",
    "document_face_image_url": "URL del rostro del documento"
  },
  "response_liveness_success": {
    "result": "true/false",
    "url_selfie_image": "URL de la foto obtenida para validar vivacidad"
  },
  "result_facematch": {
    "facematch_result": "approved / decline",
    "facematch_confidence": "Porcentaje de coincidencia (0-100)"
  },
  "reporte_de_biometria": {
    "report": "URL del reporte de biometría (web)",
    "report_pdf": "URL del reporte de biometría (PDF)"
  }
}
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:
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.

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