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: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.
Toma una foto
El usuario captura una foto en tiempo real desde la cámara, con guías visuales que aseguran una toma correcta.
Captura su documento de identidad
Se solicitan imágenes frontal y reverso del documento, con asistencia visual para validar vigencia y autenticidad.
¿Cómo conectar la integración?
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.
Conecta la integración
Al conectarla verás el nodo Biometría, en el cual podrás configurar reintentos, experiencia y validaciones adicionales.
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.
Configuración
- Outputs
Éxito
Biometría Aprobada
Biometría Aprobada
Confirma que la verificación biométrica fue exitosa.Variable: Campos importantes:
approvedDescripción: Biometría AprobadaEstructura de respuesta (JSON):document_response: Información del documento de identidadliveness_response: Foto enviada para validar la prueba de vidafacematch_response: Resultado de la comparación facialreporte_de_biometria: URLs del reporte en formato web y PDFdevice_info: Datos de dispositivo y ubicación (auditoría y trazabilidad)gov_entity_data: Datos de la entidad gubernamental (si aplica)
- 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
Proceso abandonado
Proceso abandonado
El usuario abandonó el proceso antes de completarlo.Variable:
incompleteDescripción: Proceso abandonadoBiometría Rechazada
Biometría Rechazada
La verificación biométrica falló o fue rechazada.Variable:
rejectDescripción: Biometría RechazadaError en el proceso
Error en el proceso
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.- General
- Experiencia
- Validaciones
Configura la cantidad de reintentos permitidos por etapa del proceso biométrico.
- Máximo intentos en prueba de vida — define cuántas veces el usuario puede reintentar la captura facial antes de que el proceso falle.
- Máximo intentos en verificación de documento — define cuántas veces el usuario puede reintentar la captura del documento.
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:| Campo | Descripción |
|---|---|
| Código de Biometría | Identificador único del proceso |
| Fecha y Hora | Timestamp de la verificación |
| Resultado Biometría | Aprobado / Desaprobado |
| Número de Identificación | Documento del usuario |
| Tipo de Identificación | Tipo de documento |
| Nombres | Nombres del usuario |
| Apellidos | Apellidos del usuario |
| Celular | Teléfono |
| Foto | URL de la selfie |
| Resultado Prueba de Vida | Aprobado / Desaprobado |
| Foto Documento Delantera | URL |
| Foto Documento Posterior | URL |
| Resultado Document Check | Aprobado / Desaprobado |
| Foto Rostro en Documento | URL |
| Resultado Facematch | Porcentaje de coincidencia |
| Reporte de Biometría | URL del reporte |
| Descripción de Fallo | Detalle del error |
| Observaciones | Notas adicionales |
| User Agent | Cadena del agente de usuario del navegador |
| Browser | Navegador (ej. Chrome) |
| Operating System | Sistema operativo del dispositivo |
| Platform | Plataforma (ej. Linux aarch64) |
| Language | Idioma configurado (ej. es-US) |
| Timezone | Zona horaria (ej. America/Guayaquil) |
| Screen Resolution | Resolución de pantalla (ej. 376x835) |
| Color Depth | Profundidad de color en bits |
| Timestamp (device) | Marca de tiempo del dispositivo |
| IP Address | Dirección IP desde la que se realizó la verificación |
| Latitude | Latitud de la ubicación |
| Longitude | Longitud de la ubicación |
| Device ID | Identificador único del dispositivo |
| Device Name | Nombre del dispositivo (ej. Linux - Chrome) |
El reporte biométrico se encuentra disponible para descargarlo en formato PDF y utilizarlo para auditoría o respaldo interno.
Preguntas frecuentes
¿Qué documentos se necesitan durante el proceso biométrico?
¿Qué documentos se necesitan durante el proceso biométrico?
Se requieren fotos del documento de identidad por ambos lados: frontal y reverso.
¿En qué se diferencia la biometría WebView de Flows o conversacional?
¿En qué se diferencia la biometría WebView de Flows o conversacional?
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.
¿Puedo personalizar colores e idioma de la UI?
¿Puedo personalizar colores e idioma de la UI?
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.
¿Cuántos outputs tiene este agente?
¿Cuántos outputs tiene este agente?
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.