Agente de Biometría con Vivacidad activa

Versión: 1.2.2-public.beta.3

Países disponibles: 🇪🇨 Ecuador (Id Card 2021), 🇨🇴 Colombia (Id Card 2020), 🇨🇱 Chile (Id Card 2013), 🇵🇪 Perú (Id Card 2005), 🇲🇽 México (Voter Card 2014, 2019)

El Agente de Biometría es un sistema multiagente diseñado para garantizar la autenticación y verificación de identidad de manera confiable y eficiente, sin necesidad de salir del chat. Su funcionalidad se basa en tres etapas: Prueba de vida, validación de documento (document check) y comparación facial (facematch). Durante estas etapas, se implementan métodos como la generación de OTP (One-Time Password), transcripción de audio a texto, y validación sincronizada del movimiento de labios frente al audio emitido (Lipsync), asegurando la autenticidad de todas las interacciones.

Experiencia de usuario

Prueba de vida

Se solicita al usuario que envíe un video-selfie en el cual debe mencionar una secuencia numérica única (OTP). A este video se le hacen una serie de validaciones de tal manera que se pueda asegurar que el video ha sido capturado en tiempo real y no haya sido generado o manipulado con herramientas fraudulentas.

Validación de documento

Se solicita al usuario que proporcione fotografías de su documento de identidad, las cuales son verificadas en colaboración con diversas entidades gubernamentales a nivel país, garantizando que estén vigentes, no hayan sido alteradas y cumplan con los estándares de seguridad correspondientes.

Comparación Facial

Se emplea la técnica de “match facial 1:1” para determinar si dos imágenes faciales corresponden a la misma persona, aplicando un nivel de tolerancia definido para asegurar la precisión del resultado.¿Cómo lo logramos?El video selfie obtenido durante la prueba de vida se compara con dos posibles fuentes:

Foto del Documento de Identidad: Utilizamos la foto extraída del documento, asegurándonos previamente de que el documento sea auténtico
Foto Registrada en la Entidad Gubernamental: Cuando está disponible, también comparamos el video selfie con la foto almacenada en bases de datos gubernamentales.

Arquitectura

El Agente de Biometría está compuesto por tres agentes especializados:

Agente Prueba de Vida - Validación de liveness mediante video-selfie con OTP
Agente Document Check - Verificación de autenticidad y vigencia del documento
Agente Facematch - Comparación facial 1:1 entre el video y el documento/entidad gubernamental

Estos agentes pueden integrarse al agente principal o utilizarse de manera independiente para implementaciones personalizadas. Por ejemplo, es posible utilizar únicamente el agente de Document check AI sin necesidad de implementar todo el sistema de biometría, siempre que la solución completa cumpla con los requisitos legales establecidos para el caso de uso en ambiente de Producción.Nota: El uso de agentes de manera independiente está disponible únicamente para usuarios Enterprise.

Configuración

Inputs
Outputs

Idioma

string

default:"Es"

Variable: language. Permite definir el idioma de la experiencia.Valores disponibles: Es (Español), En (Inglés)

Cant. máxima intentos Biometría

number

default:"4"

Variable: maxBiometricAttempts. Cantidad máxima de intentos de la Biometría.Valores disponibles: 1-6

Email notificación reintentos excedidos

string

Variable: customerServiceEmail. Correo al que se notificará cuando se supere la cantidad máxima de intentos.

PDF términos y condiciones

string

Variable: termsAndConditionsPdf. URL pública para PDF de términos y condiciones. Por defecto: sin términos y condiciones.

Habilitar Video de Introducción Prueba de Vida

boolean

default:"false"

Variable: enableIntroVideo. Determina si se debe mostrar el video de introducción al usuario antes de comenzar el proceso.

URL para mostrar media de Introducción Prueba de Vida

string

Variable: introMediaUrl. URL que se muestra al usuario para cargar un video o imagen de introducción.

Duración máxima código OTP

number

default:"1"

Variable: otpDuration. Duración máxima en minutos del código OTP.Valores disponibles: 1-10

Longitud código OTP en Chat

number

default:"4"

Variable: otpLength. Cantidad de dígitos del código OTP.Valores disponibles: 3-6

Verificar fecha de expiración del documento

string

default:"Desactivado"

Variable: dateExpiracyCheck. Verifica la fecha de expiración del documento.Valores disponibles: Desactivado, Activado

Habilitar validación gubernamental

boolean

default:"true"

Variable: flagGovValidation. Habilita validación gubernamental; en false no se consulta al registro civil.

% Umbral aceptado en comparación facial

number

default:"60"

Variable: facematchThreshold. Porcentaje mínimo requerido en facematch.Valores disponibles: 55-95

Habilitar Human in the loop

boolean

default:"false"

Variable: enableHumanInLoop. Indica si se activa el proceso de revisión con un asesor humano.

Habilitar LipSync

boolean

default:"false"

Variable: enableLipSync. Habilita LipSync para comparar labios con el audio.

Cant. máxima intentos del Agente

string

default:"Indefinida"

Variable: retriesAgent. Cantidad máxima de intentos del Agente para bloquear al usuario.Valores disponibles: Indefinida, 1, 2, 3

Tiempo de Bloqueo del usuario

string

default:"1 dia"

Variable: blockingInHours. Tiempo de bloqueo tras exceder intentos.Valores disponibles: 1 dia, 1 semana, 1 mes

✅ Éxito

Verificación Biométrica Aprobada

La verificación biométrica se ha completado exitosamente.Variable: biometricVerificationSuccessEstructura de respuesta:

{
  "response_document_check_success": {
    "document_check": {
      "verified_fields": {
        "...": "Datos principales del documento"
      },
      "secondary_fields": {
        "...": "Datos secundarios del documento"
      },
      "details": {
        "...": "Detalles del tipo de documento"
      },
      "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"
      }
    },
    "gov_entity_data": {
      "...": "Datos obtenidos de la entidad gubernamental del país"
    },
    "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 del documento"
  },
  "response_liveness_success": {
    "url_video_liveness": "Url del video que envió el usuario",
    "url_selfie_image": "Url del frame obtenido del video para validar la vivacidad"
  },
  "result_facematch": {
    "facematch_result": "Resultado del facematch (por ejemplo `approved` o `decline`)",
    "facematch_confidence": 99
  },
  "reporte_de_biometria": {
    "report": "Url del reporte de Biometría generado",
    "report_pdf": "Url del reporte en PDF de Biometría generado"
  }
}

Campos importantes:

response_document_check_success: Información del documento de identidad
response_liveness_success: Video enviado para validar la prueba de vida
result_facematch: Resultado de la comparación facial
reporte_de_biometria: URLs del reporte en formato web y PDF

Definición de variables del JSON response:response_document_check_success:

document_check: Objeto con toda la información extraída y validada del documento
- verified_fields: Campos principales verificados del documento (nombres, apellidos, fechas, etc.)
- secondary_fields: Campos secundarios extraídos del documento
- details: Detalles del tipo de documento reconocido
- image_quality_details: Resultados de las validaciones de calidad de imagen
- images_extracted: URLs de las imágenes extraídas del documento (portrait, signature, etc.)
- gov_entity_fields: Campos utilizados para validar con la entidad gubernamental
gov_entity_data: Datos obtenidos de la entidad gubernamental del país (varía según el país)
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 de la foto del rostro extraída del documento

response_liveness_success:

url_video_liveness: URL del video-selfie enviado por el usuario durante la prueba de vida
url_selfie_image: URL del frame extraído del video utilizado para validar la vivacidad

result_facematch:

facematch_result: Resultado de la comparación facial (approved si coincide, decline si no coincide)
facematch_confidence: Porcentaje de confianza en la comparación (0-100)

reporte_de_biometria:

report: URL del reporte de biometría generado en formato web
report_pdf: URL del reporte de biometría generado en formato PDF

🔴 Errores

Error en el Servicio

Ha ocurrido un problema con el servicio.Variable: serviceError

Validación de Documento no exitosa

No se logró validar el documento del usuario.Variable: documentCheckError

Términos y Condiciones No Aceptados

El usuario no ha aceptado los términos y condiciones requeridos para continuar.Variable: termsNotAcceptedError

Proceso Abandonado

El usuario abandonó el proceso.Variable: userExitProcess

Error al guardar en datum

Se generó un error al crear o actualizar el registro en Datum.Variable: datumError

Prueba de vida no exitosa

No se logró detectar la vivacidad del usuario.Variable: livenessError

Error en la Verificación de Reconocimiento Facial

La verificación de reconocimiento facial no se ha completado con éxito.Variable: facematchError

Tiempo Expirado

El tiempo para completar el proceso ha expirado.Variable: timeExpiredError

Usuario Bloqueado

Usuario Bloqueado.Variable: userBlocked

Datum

Por defecto se crea una base de datos llamada “Reporte Agente de Biometría” 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	Estado final del proceso
Número de Identificación	Documento del usuario
Tipo de Identificación	Tipo de documento
Nombres	Nombres del usuario
Apellidos	Apellidos del usuario
Fecha de Nacimiento	Fecha de nacimiento
Celular	Teléfono del usuario
Email	Correo electrónico
Dirección	Dirección del usuario
Resultado Prueba de Vida	Estado de la prueba de vida
Video Selfie	URL del video
Foto Selfie	URL de la foto extraída
Resultado Document Check	Estado de validación del documento
Foto de Documento Delantera	URL de la imagen frontal
Foto de Documento Posterior	URL de la imagen posterior
Foto Rostro en Documento	URL de la foto del documento
Entidad Gubernamental	Entidad consultada
Resultado Facematch %	Porcentaje de coincidencia facial
Reporte de Biometría	URL del reporte web
Descripción de Fallo	Detalles del error (si aplica)
Observaciones	Notas adicionales

El reporte biométrico se encuentra disponible para descargarlo en formato PDF, allí se encuentra el resumen del proceso biométrico del usuario por cada interacción.

Integración

Seleccionar el skill

Te ubicas en el Skill dentro de la company donde requieres instalar este Agente. Busca en la barra de la izquierda “Skills” → “Abrir Marketplace” y allí escribes el nombre del Agente y lo descargas.

Configuración inicial

Lo primero que debes configurar es la Versión que se encuentra en “configuración avanzada”.Ninguno de los inputs es campo obligatorio porque se tienen asignados valores por defecto. Si requieres cambiarlo puedes ingresarlo en el campo correspondiente.Importante: El campo “PDF Términos y Condiciones” debe completarse únicamente si el cliente necesita informar a sus usuarios sobre información específica de su empresa. En ese caso, debes subir aquí el archivo PDF de los T&C proporcionado por el cliente.

Configurar Outputs

Este Agente cuenta con 8 outputs de error y 1 de success. Cada uno de ellos puedes dirigirlo a:

Una cajita de texto con mensaje personalizado
Al PMA (Panel Multiagente) si el cliente cuenta con este módulo

Realizar pruebas

Con la configuración que acabas de realizar, puedes proceder a realizar las pruebas utilizando como precursor un skill u otro agente.

Preguntas frecuentes

¿El agente responde si no ingreso datos en ningún campo?

Sí, el agente puede responder porque todos los campos tienen valores por defecto. Sin embargo, es obligatorio seleccionar la versión del agente; te recomendamos elegir la última versión pública disponible.

¿Qué documentos se necesitan durante el proceso biométrico?

Solo necesitas subir una foto del documento de identidad.

¿Es posible omitir algún paso en este agente?

Sí, puedes utilizar cualquiera de los tres componentes (Prueba de Vida, Document Check, Facematch) de manera independiente. Sin embargo, en ese caso, deberías optar por instalar los agentes disponibles en el Marketplace que se ajusten a tu necesidad específica, como se detalla en la sección de Arquitectura.

¿Puedo personalizar los textos de este agente?

Sí, puedes modificar los textos de interacción. Si necesitas agregar preguntas, condicionales u otras personalizaciones avanzadas, te sugerimos consultar con el equipo de Marketplace.

¿Puedo cambiar o prescindir de los términos y condiciones?

Sí, si no se envían términos y condiciones, la interacción del agente no se verá afectada. Sin embargo, también puedes proporcionar términos y condiciones personalizados si lo prefieres.

Empezando

Agentes IA

Nodos

Variables

Tools

Configuración

Marketplace

Identidad y firma

Enterprise

Facturación

Agente de Biometría con Vivacidad activa

Experiencia de usuario

Arquitectura

Configuración

✅ Éxito

🔴 Errores

Datum

Integración

Preguntas frecuentes

Empezando

Agentes IA

Nodos

Variables

Tools

Configuración

Marketplace

Identidad y firma

Enterprise

Facturación

​Experiencia de usuario

​Arquitectura

​Configuración

​✅ Éxito

​🔴 Errores

​Datum

​Integración

​Preguntas frecuentes

Experiencia de usuario

Arquitectura

Configuración

✅ Éxito

🔴 Errores

Datum

Integración

Preguntas frecuentes