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

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):
{
  "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

¿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.
  • 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:
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.

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.