Skip to main content
Este agente te permite ejecutar una verificación de identidad completa dentro de WhatsApp mediante WebView, combinando prueba de vida por foto, validación de documento y comparación facial. La experiencia se abre en un enlace único desde el chat y utiliza captura guiada con feedback inmediato.
En prueba de vida y document check, WebView usa captura guiada con retroalimentación en pantalla; el usuario permanece en el chat.

Requisitos previos

✅ Checklist para iniciar sin bloqueos

  • Debes contar con cuenta verificada en WhatsApp.
  • Debes contar con la URL púbica de Términos y Condiciones 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).
  • También se piden permisos de ubicación para la obtención de datos que permiten una mejor auditoría y trazabilidad del proceso biométrico.

¿Cómo funciona?

En menos de 1 minuto, el usuario completa los siguientes pasos:
1

Accede desde un link único

El usuario recibe un link único por WhatsApp para iniciar la sesión. El link contiene un identificador de sesión no reutilizable y la información del flujo asociado.
2

Toma una foto

El usuario captura una foto en tiempo real desde la cámara, con guías visuales que aseguran una toma correcta.
3

Captura su documento de identidad

Se solicitan imágenes frontal y reverso del documento, con asistencia visual para validar vigencia y autenticidad.
4

Comparación facial automática

El sistema compara la foto contra el rostro extraído del documento y calcula el nivel de similitud. En esta versión aún no se incluye facematch contra entidades gubernamentales.

¿Cómo conectar la integración?

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

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 cual podrás configurar reintentos, experiencia y validaciones adicionales.
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.

Configuración

Éxito

Confirma que la verificación biométrica fue exitosa.Variable: approvedDescripción: Biometría AprobadaEstructura de respuesta (JSON):
Campos importantes:
  • document_response: Información del documento de identidad
  • liveness_response: Foto enviada para validar la prueba de vida
  • facematch_response: Resultado de la comparación facial
  • reporte_de_biometria: URLs del reporte en formato web y PDF
  • device_info: Datos de dispositivo y ubicación (auditoría y trazabilidad)
  • gov_entity_data: Datos de la entidad gubernamental (si aplica)
Definición de variables del JSON response:
  • document_response: document_check (result, verified_fields, secondary_fields, details, status_fields, image_quality_details, images_extracted, gov_entity_fields), document_image_front_url, document_image_back_url, document_face_image_url
  • liveness_response: result, url_selfie_image
  • facematch_response: facematch_result (approved/decline), facematch_confidence
  • reporte_de_biometria: report, report_pdf
  • device_info: userAgent, browser, operatingSystem, platform, language, timezone, screenResolution, colorDepth, timestamp, ipAddress, location (latitude, longitude; solo si hay permiso de ubicación), deviceId, deviceName
  • gov_entity_data: datos de la entidad gubernamental del país (campos varían según el país)

Errores

El usuario abandonó el proceso antes de completarlo.Variable: incompleteDescripción: Proceso abandonado
La verificación biométrica falló o fue rechazada.Variable: rejectDescripción: Biometría Rechazada
Error durante la ejecución del proceso de biometría.Variable: errorDescripción: Error en el proceso

¿Cómo personalizar la experiencia?

Al hacer clic en el nodo Biometría en el canvas, se abre un panel lateral con tres pestañas de configuración.
Configura la cantidad de reintentos permitidos por etapa del proceso biométrico.Variable: Máximo intentos en prueba de vidaDescripción: Define cuántas veces el usuario puede reintentar la captura facial antes de que el proceso falle.Input: 1, 2 o 3
Variable: Máximo intentos en verificación de documentoDescripción: Define cuántas veces el usuario puede reintentar la captura del documento.Input: 1, 2 o 3
Personaliza la apariencia de la WebView que verá el usuario final. Usa el botón Vista previa para visualizar el mockup de cada pantalla antes de publicar.Variable: ColoresDescripción: Usa los colores de Jelou (por defecto) o define colores propios para botones, steppers, spinners, fondo y texto.Input: Código de color en formato HEX (ej. #1E7A4C)
Variable: Idioma de la experienciaDescripción: Define el idioma por defecto de la UI que verá el usuario al iniciar el proceso.Input: Español, Inglés o Portugués
Variable: Toggle de idiomaDescripción: Se activa un botón en la interfaz del usuario que permite al usuario cambiar el idioma.Input: Activado / Desactivado.
Define los niveles mínimos de validación que debe superar el usuario para que el proceso se considere exitoso.

Verificación documental

Controla qué tan estricto es el análisis del documento de identidad. Elige entre tres niveles:
Las variables tipo y origen del documento y fecha de vigencia no pueden desactivarse bajo ningún nivel seleccionado.
En poblaciones con alta presencia de documentos antiguos o deteriorados, el nivel Avanzado puede aumentar la tasa de derivación a revisión manual (HIL). Evalúa la calidad documental típica de tu base de usuarios antes de activarlo.

Comparación facial

Variable: Comparación facial (facematch)Descripción: Define el porcentaje mínimo de similitud aceptado entre la selfie de prueba de vida y el rostro extraído del documento.Input: Bajo (65%), Estándar (80%) o Estricto (90%). El umbral es 100% configurable por empresa; el valor por defecto es 70%.
Un umbral de facematch más alto reduce el riesgo de suplantación, pero puede aumentar el falso rechazo de usuarios legítimos. Ajusta el valor según el nivel de riesgo aceptable para tu operación.

URL Términos y condiciones

Variable: URL Términos y condicionesDescripción: El usuario debe aceptar los términos en la pantalla inicial antes de comenzar el proceso.Input: URL pública (el enlace debe ser de acceso público)
Esta configuración es global para tu empresa: si la modificas, se actualizará en todos los flujos que usen biometría WebView.

Reporte

Por defecto se genera un reporte con los siguientes campos:
El reporte biométrico se encuentra disponible para descargarlo en formato PDF y utilizarlo para auditoría o respaldo interno.
Ubicación en el reporte: Los datos de ubicación (latitud, longitud) dependen del permiso otorgado por el usuario. Si el usuario deniega el acceso a la ubicación o el dispositivo tiene desactivado el uso de ubicación, estos campos no estarán disponibles en el reporte.

Preguntas frecuentes

Se requieren fotos del documento de identidad por ambos lados: frontal y reverso.
WebView abre un enlace dedicado con captura guiada; el reporte incluye datos de dispositivo (navegador, SO, resolución, zona horaria, IP, device ID) y ubicación si el usuario concede permiso. Puedes ajustar colores (fondo, textos, botones, stepper), idioma de la UI y opciones de seguridad descritas en la guía de personalización; los widgets de captura no son editables. Conversacional usa video en el chat; Flows usa foto dentro de WhatsApp Flows con reglas propias de galería y UI nativa.
Sí: colores de fondo, de textos, de botones y del stepper; idioma de la UI (Español/Inglés) y, si aplica, selector de idioma para el usuario. El color del stepper también aplica a los widgets. Los widgets de captura facial y de documento no son modificables.
Tiene 1 output de éxito (Biometría Aprobada) y 3 outputs de error (Proceso abandonado, Biometría Rechazada, Error en el proceso). Cada uno puedes dirigirlo a mensaje personalizado o Connect.