Pular para o conteúdo principal
Versão: sempre use a versão mais recente disponível
Este agente permite executar uma verificação de identidade completa dentro do WhatsApp Flows, combinando verificação de presença por foto, validação de documento e comparação facial.
Este agente bloqueia o uso de documentos da galeria ou arquivos, prevenindo fraudes.

Pré-requisitos

✅ Checklist para começar sem bloqueios

  • Você deve ter uma conta WhatsApp verificada.
  • 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 tirar fotos pelo chat (as permissões de câmera devem estar habilitadas no dispositivo).
  • Recomendado: defina o fluxo de atendimento caso 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 as seguintes etapas:
1

Tirar uma foto do rosto

Usando a câmera frontal, o usuário tira uma foto do seu rosto. O acesso à galeria de fotos ou documentos é bloqueado.
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. O acesso à galeria de fotos ou documentos é bloqueado.
3

Comparação facial automática

O sistema aplica a técnica 1:1, comparando a foto com a imagem no documento (ou com a fonte governamental oficial, se habilitada).
A configuração de limite, expiração e tratamento de erros dependem de cada etapa do fluxo.

Como o agente é composto?

O Agente de Biometria (Flows) é composto por três agentes especializados:
  1. Agente de verificação de presença com WhatsApp Flows - Valida a presença da pessoa por foto: confirma que há um único rosto, detecta recapturas e avalia sinais de tentativa de fraude.
  2. Agente de verificação de documento - Verifica a autenticidade e validade do documento, detecta recapturas e avalia sinais de tentativa de fraude.
  3. Agente de comparação facial - Comparação facial 1:1 entre a foto e o rosto do documento/entidade governamental. Como resultado, entrega um percentual de correspondência e status binário (aprovado/rejeitado) de acordo com o limite configurado.
Se você precisar implementar apenas 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

Encontre o agente no Marketplace

No Marketplace você verá três abas: Catálogo, Instalados e Desenvolvedores. Clique em Desenvolvedores e use a barra de pesquisa para encontrar o Biometrics flows agent. Em seguida, clique no ícone de download para instalá-lo.
3

Confirme a instalação

Se a instalação foi concluída com sucesso, você verá a tag Instalado em verde.
4

Abra o agente no Brain

Vá para o Brain. Na barra lateral você verá suas skills e ferramentas instaladas. Pesquise pelo Biometrics flows agent e clique para abri-lo: o nó será carregado no seu canvas.
5

Configuração inicial

  • Clique no nó, abra as Configurações avançadas (na parte inferior) e selecione a versão do agente.
  • Nenhuma das entradas (exceto o PDF) requer alterações se você usar os valores padrão. Se precisar alterá-las, pode inseri-las no campo correspondente.
  • Se quiser modificar alguma entrada, configure-as na barra lateral.
6

Configure as Saídas

Este agente tem 10 saídas de erro e 1 saída de sucesso. Cada uma pode ser direcionada para:
  • Uma entrada de texto com uma mensagem personalizada.
  • Connect, somente se você tiver este módulo.
7

Execute 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

Máximo de tentativas biométricas
number
padrão:"2"
Variável: maxBiometricAttempts. Valores disponíveis: 1-4
Email de notificação para tentativas excedidas
string
Variável: customerServiceEmail. Email de alerta quando as tentativas são excedidas.
Limite aceito para comparação facial
number
padrão:"60"
Variável: facematchThreshold. Valores disponíveis: 55-95 Percentual mínimo de aprovação para comparação facial.
Verificar data de validade
string
padrão:"false"
Variável: dateExpiracyCheck. Valores disponíveis: false, true Habilita o controle de validade do documento.
Habilitar validação governamental
boolean
padrão:"false"
Variável: flagGovValidation. Valores disponíveis: false, true Define se uma fonte oficial será consultada.
Habilitar termos e condições
boolean
padrão:"false"
Valores disponíveis: false, true Defina como “true” para carregar a URL dos termos e condições
PDF de termos e condições (obrigatório)
string (URL)
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 mostrado ao usuário antes de iniciar o processo.
Habilitar Human in the loop
boolean
padrão:"false"
Variável: enableHumanInLoop. Valores disponíveis: false, true Indica se o processo de revisão com um agente humano é ativado. Serviço adicional com custo extra.
Editar imagens do fluxo
boolean
padrão:"false"
Variável: validateImage. Valores disponíveis: false, true Permite substituir imagens padrão. Quando a edição é habilitada, cinco campos são exibidos para integrar imagens personalizadas. O guia passo a passo para personalização está na seção “Personalização”.

Relatório

Por padrão, um banco de dados chamado “Relatório do Agente Biométrico” é criado 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
Resultado da Verificação de PresençaStatus da verificação de presença
Foto SelfieURL da foto extraída
Resultado do Document CheckStatus 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.

Personalização

Você pode personalizar apenas as imagens que aparecem em cada tela; o restante do texto do fluxo não é personalizável.
Nas telas do fluxo, os campos marcados com uma caixa amarela são personalizáveis. Os textos restantes não podem ser modificados.
Visão geral do fluxo biométrico no Flows com caixas amarelas nos campos personalizáveis
Visão geral do fluxo de documento no Flows com caixas amarelas nas seções personalizáveis

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 dos dois lados: frente e verso.
Não. Este agente é projetado como um fluxo completo: foto + documento + facematch. Se você precisar apenas de parte dele (por exemplo, apenas documento), deve instalar os agentes por etapa.
Não, você não pode modificar os textos de interação. Você pode adicionar mensagens, condicionais e outras personalizações em sua skill no canvas.
O HIL é um serviço adicional com custo extra. Quando ativo, alguns casos podem ir para revisão manual (por exemplo, se o limite não for atingido ou as tentativas forem esgotadas). Neste agente, a revisão manual é aplicada após a validação do documento.
  • Criptografia em trânsito e em repouso.
  • Registro de evidências com hashes para garantir a integridade.
  • Controle de acesso com funções (RBAC) e MFA.
Depende da sua configuração:
  • Máximo de tentativas biométricas (maxBiometricAttempts): controla as tentativas biométricas.