Pré-requisitos
✅ Checklist para começar sem bloqueadores
- Você deve ter um PDF de Termos e Condições (URL pública) para configurar no agente. Isso é obrigatório.
- O usuário deve ser capaz de gravar vídeo pelo chat (as permissões de câmera devem estar habilitadas no dispositivo).
- Recomendado: defina o fluxo de tratamento caso você habilite o Human in the loop (quem revisa, tempos de resposta e o que acontece se não houver resposta).
Como funciona?
Em menos de 1 minuto, o usuário conclui os dois primeiros passos:Gravar um video selfie
Capturar fotos do documento de identidade
Como é composto o Agente?
O Agente de Biometria é composto por três agentes especializados:- Agente de verificação de vivacidade - Validação de vivacidade via video selfie com OTP
- Agente de verificação de documento - Verificação da autenticidade e validade do documento
- Agente de comparação facial - Comparação facial 1:1 entre o vídeo e o documento/entidade governamental
Conexão pelo Marketplace
Acesse a plataforma
Conecte a integração
Configuração inicial
- Para usar validação por vídeo, selecione “Biometria passiva com vivacidade”
- A primeira coisa a configurar é a versão encontrada em “Configurações avançadas” (na parte inferior).
- Nenhum dos inputs (exceto o PDF) requer alterações se você usará os valores padrão. Se precisar alterá-los, pode inseri-los no campo correspondente.
- Se quiser modificar algum input, vá para a seção Configurações.
Configurar Outputs
- Um input de texto com uma mensagem personalizada.
- Connect, somente se você tiver este módulo.
Configuração
- Inputs
- Outputs
Idioma
Idioma
language. Define o idioma da experiência.Valores disponíveis: Es (Espanhol), En (Inglês)Máximo de tentativas biométricas
Máximo de tentativas biométricas
maxBiometricAttempts. Número máximo de tentativas biométricas.
Valores disponíveis: 1-4Email de notificação para tentativas excedidas
Email de notificação para tentativas excedidas
customerServiceEmail. Email a ser notificado quando o número máximo de tentativas for excedido.PDF de Termos e Condições (obrigatório)
PDF de Termos e Condições (obrigatório)
termsAndConditionsPdf. URL pública do PDF de Termos e Condições.Deve detalhar explicitamente o tratamento de dados pessoais, incluindo o uso, armazenamento e processamento de informações biométricas.
Deve ser apresentado ao usuário antes de iniciar o processo.Habilitar vídeo de introdução à vivacidade
Habilitar vídeo de introdução à vivacidade
enableIntroVideo. Determina se um vídeo de introdução deve ser exibido ao usuário antes de iniciar o processo.URL para exibir mídia de introdução à vivacidade
URL para exibir mídia de introdução à vivacidade
introMediaUrl. URL exibida ao usuário para carregar um vídeo ou imagem de introdução.Duração máxima do código OTP
Duração máxima do código OTP
otpDuration. Duração máxima em minutos do código OTP.Valores disponíveis: 1-10Comprimento do código OTP no Chat
Comprimento do código OTP no Chat
otpLength. Número de dígitos no código OTP.Valores disponíveis: 3-6Verificar data de validade do documento
Verificar data de validade do documento
dateExpiracyCheck. Verifica a data de validade do documento.Valores disponíveis: Disabled, EnabledHabilitar validação governamental
Habilitar validação governamental
flagGovValidation. Habilita a validação governamental; quando false, o registro civil não é consultado.Limiar aceito para comparação facial
Limiar aceito para comparação facial
facematchThreshold. Percentual mínimo exigido no facematch.Valores disponíveis: 55-95Habilitar Human in the loop
Habilitar Human in the loop
enableHumanInLoop. Indica se o processo de revisão com um agente humano está ativado.Habilitar LipSync
Habilitar LipSync
enableLipSync. Habilita o LipSync para comparar o movimento dos lábios com o áudio.Máx. de tentativas do agente
Máx. de tentativas do agente
retriesAgent. Número máximo de tentativas do agente antes de bloquear o usuário.Valores disponíveis: Unlimited, 1, 2, 3Duração do bloqueio do usuário (em horas)
Duração do bloqueio do usuário (em horas)
blockingInHours. Duração do bloqueio (em horas) após exceder as tentativas.Valores disponíveis: inteiro (ex.: 2, 24, 168)Relatório
Por padrão, é criado um banco de dados chamado “Relatório do Agente Biométrico” com os seguintes campos:| Campo | Descrição |
|---|---|
| Código Biométrico | Identificador único do processo |
| Data e Hora | Timestamp da verificação |
| Resultado Biométrico | Status final do processo |
| Número de Identificação | Documento do usuário |
| Tipo de Identificação | Tipo de documento |
| Primeiros Nomes | Primeiros nomes do usuário |
| Sobrenomes | Sobrenomes do usuário |
| Data de Nascimento | Data de nascimento |
| Telefone | Número de telefone do usuário |
| Endereço de email | |
| Endereço | Endereço do usuário |
| Resultado da Verificação de Vivacidade | Status da verificação de vivacidade |
| Video Selfie | URL do vídeo |
| Foto Selfie | URL da foto extraída |
| Resultado da Verificação de Documento | Status da validação do documento |
| Foto Frontal do Documento | URL da imagem frontal |
| Foto do Verso do Documento | URL da imagem do verso |
| Foto do Rosto no Documento | URL da foto do rosto no documento |
| Entidade Governamental | Entidade consultada |
| Resultado do Facematch | Percentual de correspondência facial |
| Relatório Biométrico | URL do relatório web |
| Descrição da Falha | Detalhes do erro (se aplicável) |
| Observações | Notas adicionais |
Perguntas frequentes
O agente responde se eu não inserir dados em nenhum campo?
O agente responde se eu não inserir dados em nenhum campo?
Quais documentos são necessários durante o processo biométrico?
Quais documentos são necessários durante o processo biométrico?
É possível pular alguma etapa neste agente?
É possível pular alguma etapa neste agente?
Posso personalizar os textos neste agente?
Posso personalizar os textos neste agente?
Posso alterar ou remover os termos e condições?
Posso alterar ou remover os termos e condições?
O que acontece se o OTP expirar ou o usuário abandonar o fluxo?
O que acontece se o OTP expirar ou o usuário abandonar o fluxo?
Quantas tentativas o usuário tem antes de ser bloqueado?
Quantas tentativas o usuário tem antes de ser bloqueado?
- Máximo de tentativas biométricas (
maxBiometricAttempts): controla as tentativas biométricas. - Máx. de tentativas do agente (
retriesAgent): controla as reinicializações do agente antes do bloqueio. - Duração do bloqueio do usuário (
blockingInHours): define quantas horas dura o bloqueio.