Pular para o conteúdo principal
Versão: sempre use a versão mais recente disponível
Este agente permite verificar a identidade de uma pessoa sem sair do chat, combinando video selfie em tempo real (verificação de vivacidade), captura de documento e comparação facial automática (1:1).
Ideal para onboarding, controle de acesso, assinaturas eletrônicas ou validações de alto risco.

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:
1

Gravar um video selfie

O usuário grava um curto vídeo em tempo real, seguindo instruções simples dentro do chat.
2

Capturar fotos do documento de identidade

São solicitadas fotos da frente e do verso do documento de identidade para validar validade e autenticidade.
3

Comparação facial automática

O sistema aplica a técnica 1:1, comparando um frame do vídeo com a imagem no documento (ou com a fonte governamental oficial, se habilitada).

Como é composto o Agente?

O Agente de Biometria é composto por três agentes especializados:
  1. Agente de verificação de vivacidade - Validação de vivacidade via video selfie com OTP
  2. Agente de verificação de documento - Verificação da autenticidade e validade do documento
  3. Agente de comparação facial - Comparação facial 1:1 entre o vídeo e o documento/entidade governamental
Se você só precisa implementar parte do processo (por exemplo, apenas documento), consulte a configuração em Agentes por etapa.

Conexão pelo Marketplace

1

Acesse a plataforma

Acesse apps.jelou.ai. Na tela inicial você verá Brain Studio e Connect. No Brain Studio, selecione Marketplace.
2

Conecte a integração

Pesquise por KYC e você verá os detalhes da integração, incluindo preços, uma funcionalidade de teste e disponibilidade por país. Para usar o teste gratuito, clique em “Conectar”. Após conectar, o canvas de trabalho no Brain será aberto para você configurar e usar.
3

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.
4

Configurar Outputs

Este agente tem 8 outputs de erro e 1 output de sucesso. Cada um pode ser direcionado para:
  • Um input de texto com uma mensagem personalizada.
  • Connect, somente se você tiver este módulo.
5

Executar testes

Com a configuração que você acabou de concluir, pode prosseguir para executar testes usando uma skill ou outro agente como precursor.
Importante: O campo “PDF de Termos e Condições” é obrigatório. O documento deve incluir explicitamente o uso, armazenamento e tratamento de dados pessoais e biométricos. Deve ser apresentado e aceito antes de iniciar o processo de verificação.

Configuração

Idioma
string
padrão:"Es"
Variável: language. Define o idioma da experiência.Valores disponíveis: Es (Espanhol), En (Inglês)
Máximo de tentativas biométricas
number
padrão:"2"
Variável: maxBiometricAttempts. Número máximo de tentativas biométricas. Valores disponíveis: 1-4
Email de notificação para tentativas excedidas
string
Variável: customerServiceEmail. Email a ser notificado quando o número máximo de tentativas for excedido.
PDF de Termos e Condições (obrigatório)
string
Variável: 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
boolean
padrão:"false"
Variável: 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
string
Variável: introMediaUrl. URL exibida ao usuário para carregar um vídeo ou imagem de introdução.
Duração máxima do código OTP
number
padrão:"1"
Variável: otpDuration. Duração máxima em minutos do código OTP.Valores disponíveis: 1-10
Comprimento do código OTP no Chat
number
padrão:"4"
Variável: otpLength. Número de dígitos no código OTP.Valores disponíveis: 3-6
Verificar data de validade do documento
string
padrão:"Disabled"
Variável: dateExpiracyCheck. Verifica a data de validade do documento.Valores disponíveis: Disabled, Enabled
Habilitar validação governamental
boolean
padrão:"false"
Variável: flagGovValidation. Habilita a validação governamental; quando false, o registro civil não é consultado.
Limiar aceito para comparação facial
number
padrão:"60"
Variável: facematchThreshold. Percentual mínimo exigido no facematch.Valores disponíveis: 55-95
Habilitar Human in the loop
boolean
padrão:"false"
Variável: enableHumanInLoop. Indica se o processo de revisão com um agente humano está ativado.
Habilitar LipSync
boolean
padrão:"false"
Variável: enableLipSync. Habilita o LipSync para comparar o movimento dos lábios com o áudio.
Máx. de tentativas do agente
string
padrão:"Unlimited"
Variável: retriesAgent. Número máximo de tentativas do agente antes de bloquear o usuário.Valores disponíveis: Unlimited, 1, 2, 3
Duração do bloqueio do usuário (em horas)
number
padrão:"2"
Variável: 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:
CampoDescrição
Código BiométricoIdentificador único do processo
Data e HoraTimestamp da verificação
Resultado BiométricoStatus final do processo
Número de IdentificaçãoDocumento do usuário
Tipo de IdentificaçãoTipo de documento
Primeiros NomesPrimeiros nomes do usuário
SobrenomesSobrenomes do usuário
Data de NascimentoData de nascimento
TelefoneNúmero de telefone do usuário
EmailEndereço de email
EndereçoEndereço do usuário
Resultado da Verificação de VivacidadeStatus da verificação de vivacidade
Video SelfieURL do vídeo
Foto SelfieURL da foto extraída
Resultado da Verificação de DocumentoStatus da validação do documento
Foto Frontal do DocumentoURL da imagem frontal
Foto do Verso do DocumentoURL da imagem do verso
Foto do Rosto no DocumentoURL da foto do rosto no documento
Entidade GovernamentalEntidade consultada
Resultado do FacematchPercentual de correspondência facial
Relatório BiométricoURL do relatório web
Descrição da FalhaDetalhes do erro (se aplicável)
ObservaçõesNotas adicionais
O relatório biométrico está disponível para download em formato PDF e contém todas as informações detalhadas na tabela.

Perguntas frequentes

Sim, o agente pode responder porque todos os campos têm valores padrão. No entanto, selecionar a versão do agente é obrigatório; recomendamos sempre selecionar a versão pública mais recente disponível.
São necessárias fotos do documento de identidade pelos dois lados: frente e verso.
Não. Este agente é projetado como um fluxo completo: video selfie + documento + facematch. Se você só precisa de parte dele (por exemplo, apenas documento), deve instalar os agentes por etapa.
Sim, você pode modificar os textos de interação. Se precisar adicionar perguntas, condicionais ou outras personalizações avançadas, sugerimos consultar a equipe do Jelou.
Não. O PDF de Termos e Condições é obrigatório para usar este agente.
Se o OTP expirar, todo o processo expira e o usuário deve reiniciar. Se o usuário abandonar o fluxo, o processo fica inacabado e expira de acordo com a lógica do agente/experiência.
Depende da sua configuração:
  • 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.