Requisitos previos
✅ Checklist para iniciar sin bloqueos
- 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 grabar video desde el chat (los permisos de cámara deben de estar habilitados en el dispositivo).
- Recomendado: definir el flujo de atención si activas Human in the loop (quién revisa, tiempos, y qué ocurre si no responde).
¿Cómo funciona?
En menos de 1 minuto, el usuario completa los dos primeros pasos:Grabar un video selfie
Capturar fotos de su documento de identidad
¿Cómo está compuesto el Agente?
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 verificación de Documento - Verificación de autenticidad y vigencia del documento
- Agente comparación facial - Comparación facial 1:1 entre el video y el documento/entidad gubernamental
Conexión desde Marketplace
Ingresa a la plataforma
Conecta la integración
Configuración inicial
- Para utilizar la validación con video, selecciona “Biometría vivacidad pasiva”
- Lo primero que debes configurar es la versión que se encuentra en “Configuración avanzada” (al final).
- Ninguno de los inputs (excepto el PDF) requiere cambios si usarás los valores por defecto. Si requieres cambiarlo puedes ingresarlo en el campo correspondiente.
- Si deseas modificar algún input, ve a la sección Configuración.
Configurar Outputs
- Input de texto con mensaje personalizado.
- Connect, solo si cuentas con este módulo.
Configuración
- Inputs
- Outputs
Idioma
Idioma
language. Permite definir el idioma de la experiencia.Valores disponibles: Es (Español), En (Inglés)Cantidad máxima intentos Biometría
Cantidad máxima intentos Biometría
maxBiometricAttempts. Cantidad máxima de intentos de la Biometría.
Valores disponibles: 1-4Email notificación reintentos excedidos
Email notificación reintentos excedidos
customerServiceEmail. Correo al que se notificará cuando se supere la cantidad máxima de intentos.PDF Términos y condiciones (obligatorio)
PDF Términos y condiciones (obligatorio)
termsAndConditionsPdf. URL pública del PDF de Términos y condiciones.Debe detallar explícitamente el manejo de datos personales, incluyendo el uso, almacenamiento y tratamiento de información biométrica.Debe mostrarse al usuario antes de iniciar el proceso.
Habilitar video de Introducción Prueba de Vida
Habilitar video de Introducción Prueba de Vida
enableIntroVideo. Determina si se debe mostrar un video de introducción al usuario antes de comenzar el proceso.URL para mostrar media de Introducción Prueba de Vida
URL para mostrar media de Introducción Prueba de Vida
introMediaUrl. URL que se muestra al usuario para cargar un video o imagen de introducción.Duración máxima código OTP
Duración máxima código OTP
otpDuration. Duración máxima en minutos del código OTP.Valores disponibles: 1-10Longitud código OTP en Chat
Longitud código OTP en Chat
otpLength. Cantidad de dígitos del código OTP.Valores disponibles: 3-6Verificar fecha de expiración del documento
Verificar fecha de expiración del documento
dateExpiracyCheck. Verifica la fecha de expiración del documento.Valores disponibles: Desactivado, ActivadoHabilitar validación gubernamental
Habilitar validación gubernamental
flagGovValidation. Habilita validación gubernamental; en false no se consulta al registro civil.Umbral aceptado en comparación facial
Umbral aceptado en comparación facial
facematchThreshold. Porcentaje mínimo requerido en facematch.Valores disponibles: 55-95Habilitar Human in the loop
Habilitar Human in the loop
enableHumanInLoop. Indica si se activa el proceso de revisión con un asesor humano.Habilitar LipSync
Habilitar LipSync
enableLipSync. Habilita LipSync para comparar labios con el audio.Cant. máxima intentos del Agente
Cant. máxima intentos del Agente
retriesAgent. Cantidad máxima de intentos del Agente para bloquear al usuario.Valores disponibles: Indefinida, 1, 2, 3Tiempo de bloqueo del usuario (en horas)
Tiempo de bloqueo del usuario (en horas)
blockingInHours. Tiempo de bloqueo (en horas) tras exceder intentos.Valores disponibles: número entero (por ejemplo: 2, 24, 168)Reporte
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 |
| 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 |
Preguntas frecuentes
¿El agente responde si no ingreso datos en ningún campo?
¿El agente responde si no ingreso datos en ningún campo?
¿Qué documentos se necesitan durante el proceso biométrico?
¿Qué documentos se necesitan durante el proceso biométrico?
¿Es posible omitir algún paso en este agente?
¿Es posible omitir algún paso en este agente?
¿Puedo personalizar los textos de este agente?
¿Puedo personalizar los textos de este agente?
¿Puedo cambiar o prescindir de los términos y condiciones?
¿Puedo cambiar o prescindir de los términos y condiciones?
¿Qué pasa si expira el OTP o el usuario abandona el flujo?
¿Qué pasa si expira el OTP o el usuario abandona el flujo?
¿Cuántos intentos tiene el usuario antes de ser bloqueado?
¿Cuántos intentos tiene el usuario antes de ser bloqueado?
- Cantidad máxima intentos Biometría (
maxBiometricAttempts): controla intentos de biometría. - Cant. máxima intentos del Agente (
retriesAgent): controla reintentos del agente antes de bloquear. - Tiempo de Bloqueo del usuario (
blockingInHours): define cuántas horas dura el bloqueo.