Versión: utiliza siempre la última versión disponible. Esta primera versión no tiene acceso al servicio HIL (Human in the Loop).
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 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).
- 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.
Conexión desde Marketplace
Ingresa a la plataforma
Entra a apps.jelou.ai.
En la pantalla de inicio verás Brain Studio y Connect. En Brain Studio, selecciona Marketplace.
Conecta la integración
Busca KYC y haz clic en Conectar.
Si tu organización está en el plan Free, verás el CTA para Subir de plan a Builder (KYC solo está disponible desde el plan Builder en adelante).
Si ves el botón Conectar y lo presionas, se abrirá el canvas de trabajo en Brain.
Configuración inicial
- Al arrastrar la integración al canvas y hacer clic, debes seleccionar la tool nativa que deseas utilizar:
- Conversacional -> Validación con video
- WebView -> Validación con foto (WebView)
- Flows -> Validación con foto (Flows)
- La versión ya se muestra por defecto en su última versión disponible.
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.
En este agente el link a términos y condiciones pasa a estar dentro de WebView en la UI. Se requiere integrar el link público de los términos y condiciones correspondientes.
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 procesoReporte
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.
Personalización
En WebView, la personalización de UI permite cambiar:- Color de fondo
- Color de textos
- Color de botones
- Color del stepper
- Widgets de captura facial
- Widgets de captura de documentos
Para el detalle completo de personalización de UI, términos legales y controles de seguridad adicionales, revisa Personalización de WebView.
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.