Skip to main content
Para activar en tu organización, debes enviar un correo a [email protected]
Última versión estable es: 1.10.1-public
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.

​
El proceso de biometría

1

Validación de documento

Se solicita al usuario que proporcione fotografías de su documento de identidad, garantizando que estén vigentes, no hayan sido alteradas y cumplan con los estándares de seguridad correspondientes.
Si tu cuenta tiene activo Whatsapp Flows, puedes usar nuestros Flows pre-construidos para mejorar la experiencia de usuario.
2

Prueba de vida

Se solicita al usuario que envíe un video-selfie en el cual debe mencionar una secuencia numérica única (OTP). Aquí usamos un modelo de speech-to-text y una comparación fonética del audio con el movimiento de labios para garantizar que el video no ha sido manipulado
Si tu cuenta tiene activo Whatsapp Flows, puedes usar nuestros Flows pre-construidos para mejorar la experiencia de usuario.
3

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.
El video selfie se compara contra el documento o, si está disponible, contra la entidad gubernamental.

​
Países disponibles

PaísCosto estimado
🇪🇨 Ecuador$0.44
🇨🇴 Colombia$0.44
🇵🇪 Perú$0.44
🇨🇱 Chile$0.44
🇵🇦 Panamá$0.44
🇲🇽 México$0.44

​
Inputs

​
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: Indefinida, 1, 2, 3.
​
Tiempo de Bloqueo del usuario
string
default:"1 dia"
Variable: blockingInHours. Tiempo de bloqueo tras exceder intentos. Valores: 1 dia, 1 semana, 1 mes.

​
Output

En la respuesta JSON se expone un ejemplo completo del resultado biométrico. El objeto principal incluye los bloques response_document_check_success, response_liveness_success, result_facematch y reporte_de_biometria, con los datos más relevantes de cada etapa: 
"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"
}

​
Códigos de error

En caso de que ocurra una falla en el servicio o el usuario no apruebe la biometría, puede manejar el flujo dentro del skill usando los siguientes caminos:
NombreVariableDescripción
Error en el ServicioserviceErrorHa ocurrido un problema con el servicio.
Validación de Documento no exitosadocumentCheckErrorNo se logró validar el documento del usuario.
Términos y Condiciones No AceptadostermsNotAcceptedErrorEl usuario no ha aceptado los términos y condiciones requeridos para continuar.
Proceso AbandonadouserExitProcessEl usuario abandonó el proceso.
Error al guardar en datumdatumErrorSe generó un error al crear o actualizar el registro en Datum.
Prueba de vida no exitosalivenessErrorNo se logró detectar la vivacidad del usuario.
Error en la Verificación de Reconocimiento FacialfacematchErrorLa verificación de reconocimiento facial no se ha completado con éxito.
Tiempo ExpiradotimeExpiredErrorEl tiempo para completar el proceso ha expirado.
Usuario BloqueadouserBlockedUsuario Bloqueado.

​
Reporte

Cuando un primer usuario pasa por el Agente de Biometría, se genera automáticamente un reporte en Datum con toda la data necesaria para auditorías, seguimiento y monitoreo del proceso.
Si necesitas información adicional sobre el reporte, escríbenos a [email protected].