KYC

Integración de verificación de identidad y cumplimiento KYC para Brain Studio.

Para activar en tu organización, debes enviar un correo a [e-mail]

Ú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ís	Costo 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:

Nombre	Variable	Descripción
Error en el Servicio	serviceError	Ha ocurrido un problema con el servicio.
Validación de Documento no exitosa	documentCheckError	No se logró validar el documento del usuario.
Términos y Condiciones No Aceptados	termsNotAcceptedError	El usuario no ha aceptado los términos y condiciones requeridos para continuar.
Proceso Abandonado	userExitProcess	El usuario abandonó el proceso.
Error al guardar en datum	datumError	Se generó un error al crear o actualizar el registro en Datum.
Prueba de vida no exitosa	livenessError	No se logró detectar la vivacidad del usuario.
Error en la Verificación de Reconocimiento Facial	facematchError	La verificación de reconocimiento facial no se ha completado con éxito.
Tiempo Expirado	timeExpiredError	El tiempo para completar el proceso ha expirado.
Usuario Bloqueado	userBlocked	Usuario 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 [e-mail].