Saltar al contenido principal
Versión: utiliza siempre la última versión disponible. Esta primera versión no tiene acceso al servicio HIL (Human in the Loop).
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 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:
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.

Conexión desde Marketplace

1

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

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

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

Realizar pruebas

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

Éxito

Confirma que la verificación biométrica fue exitosa.Variable: approvedDescripción: Biometría AprobadaEstructura de respuesta (JSON):
{
  "document_response": {
    "document_check": {
      "result": "",
      "verified_fields": { "...": "Datos principales del documento" },
      "secondary_fields": { "...": "Datos secundarios del documento" },
      "details": { "...": "Detalles del tipo de documento" },
      "status_fields": { "...": "Estado de validaciones" },
      "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" }
    },
    "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 extraído del documento"
  },
  "liveness_response": {
    "result": "true",
    "url_selfie_image": "URL de la foto obtenida para validar vivacidad"
  },
  "facematch_response": {
    "facematch_result": "approved",
    "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)"
  },
  "device_info": {
    "userAgent": "Cadena del agente de usuario",
    "browser": "Navegador",
    "operatingSystem": "Sistema operativo",
    "platform": "Plataforma del dispositivo",
    "language": "Idioma",
    "timezone": "Zona horaria",
    "screenResolution": "Resolución de pantalla",
    "colorDepth": "Profundidad de color en bits",
    "timestamp": "Marca de tiempo del dispositivo",
    "ipAddress": "Dirección IP",
    "location": {
      "latitude": "Latitud (si el usuario otorga permiso)",
      "longitude": "Longitud (si el usuario otorga permiso)"
    },
    "deviceId": "Identificador único del dispositivo",
    "deviceName": "Nombre del dispositivo"
  },
  "gov_entity_data": {
    "...": "Datos de la entidad gubernamental del país (varía según el país)"
  }
}
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

Reporte

Por defecto se genera un reporte con los siguientes campos:
CampoDescripción
Código de BiometríaIdentificador único del proceso
Fecha y HoraTimestamp de la verificación
Resultado BiometríaAprobado / Desaprobado
Número de IdentificaciónDocumento del usuario
Tipo de IdentificaciónTipo de documento
NombresNombres del usuario
ApellidosApellidos del usuario
CelularTeléfono
FotoURL de la selfie
Resultado Prueba de VidaAprobado / Desaprobado
Foto Documento DelanteraURL
Foto Documento PosteriorURL
Resultado Document CheckAprobado / Desaprobado
Foto Rostro en DocumentoURL
Resultado FacematchPorcentaje de coincidencia
Reporte de BiometríaURL del reporte
Descripción de FalloDetalle del error
ObservacionesNotas adicionales
User AgentCadena del agente de usuario del navegador
BrowserNavegador (ej. Chrome)
Operating SystemSistema operativo del dispositivo
PlatformPlataforma (ej. Linux aarch64)
LanguageIdioma configurado (ej. es-US)
TimezoneZona horaria (ej. America/Guayaquil)
Screen ResolutionResolución de pantalla (ej. 376x835)
Color DepthProfundidad de color en bits
Timestamp (device)Marca de tiempo del dispositivo
IP AddressDirección IP desde la que se realizó la verificación
LatitudeLatitud de la ubicación
LongitudeLongitud de la ubicación
Device IDIdentificador único del dispositivo
Device NameNombre 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.
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.

Personalización

En WebView, la personalización de UI permite cambiar:
  • Color de fondo
  • Color de textos
  • Color de botones
  • Color del stepper
Cuando configuras el color del stepper, ese mismo color se aplica en los widgets. No es modificable:
  • Widgets de captura facial
  • Widgets de captura de documentos
Esto garantiza la calidad de la verificación.
Para el detalle completo de personalización de UI, términos legales y controles de seguridad adicionales, revisa Personalización de WebView.

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.