Skip to main content
Este agente permite executar uma verificação de identidade completa dentro do WhatsApp via WebView, combinando vivacidade por foto, validação de documento e comparação facial. A experiência abre a partir de um link exclusivo no chat e usa captura guiada com feedback imediato.
Para vivacidade e verificação de documento, o WebView usa captura guiada com feedback na tela; o usuário permanece no chat.

Pré-requisitos

✅ Checklist para começar sem bloqueadores

  • Você deve ter uma conta WhatsApp verificada.
  • Você deve ter o PDF de Termos e Condições (URL pública) para configurar no agente. Isso é obrigatório.
  • O usuário deve conseguir tirar fotos pelo chat (permissões de câmera habilitadas no dispositivo).
  • Permissões de localização também são solicitadas para que os dados possam ser coletados para melhor auditoria e rastreabilidade do processo biométrico.

Como funciona?

Em menos de um minuto, o usuário conclui estas etapas:
1

Acesso via link exclusivo

O usuário recebe um link exclusivo do WhatsApp para iniciar a sessão. O link contém um id de sessão não reutilizável e as informações do fluxo associado.
2

Tirar uma foto

O usuário captura uma foto ao vivo pela câmera, com guias visuais para uma captura correta.
3

Capturar o documento de identidade

São solicitadas imagens da frente e do verso do documento, com assistência visual para validar validade e autenticidade.
4

Comparação facial automática

O sistema compara a foto ao rosto extraído do documento e calcula o nível de similaridade. Esta versão ainda não inclui facematch com entidades governamentais.

Como conectar a integração?

Como conectar a integração de Biometria

1

Abrir a plataforma

Use o Agente para criar um fluxo de biometria ou selecione o template Validação de identidade. Para iniciar um fluxo do zero, clique em Brain Studio na barra lateral.
2

Selecionar Biometria

Na barra de ferramentas você verá a opção Biometria. Clique em Conectar.
3

Conectar a integração

Ao conectar, você verá o nó Biometria, onde poderá configurar tentativas, experiência e validações adicionais.
4

Configurar saídas

Este agente tem 1 saída de sucesso e 3 saídas de erro. Cada uma pode direcionar para:
  • Entrada de texto com mensagem personalizada.
  • Connect, somente se você tiver este módulo.
5

Executar testes

Com a configuração que você acabou de definir, execute testes com o botão Teste.

Configuração

Sucesso

Confirma que a verificação biométrica foi bem-sucedida.Variável: approvedDescrição: Biometria aprovadaEstrutura da resposta (JSON):
Campos importantes:
  • document_response: informações do documento de identidade
  • liveness_response: foto usada na vivacidade
  • facematch_response: resultado da comparação facial
  • reporte_de_biometria: URLs do relatório (web e PDF)
  • device_info: dados do dispositivo e localização (auditoria e rastreabilidade)
  • gov_entity_data: dados de entidade governamental (se aplicável)
Definições das variáveis JSON:
  • document_response: document_check (result, verified_fields, secondary_fields, details, status_fields, image_quality_details, images_extracted, gov_entity_fields), document_image_front_url, document_image_back_url, document_face_image_url
  • liveness_response: result, url_selfie_image
  • facematch_response: facematch_result (approved/decline), facematch_confidence
  • reporte_de_biometria: report, report_pdf
  • device_info: userAgent, browser, operatingSystem, platform, language, timezone, screenResolution, colorDepth, timestamp, ipAddress, location (latitude, longitude; somente com permissão de localização), deviceId, deviceName
  • gov_entity_data: dados da entidade governamental do país (campos variam por país)

Erros

O usuário saiu do processo antes de concluir.Variável: incompleteDescrição: Processo abandonado
A verificação biométrica falhou ou foi rejeitada.Variável: rejectDescrição: Biometria rejeitada
Erro durante a execução do processo biométrico.Variável: errorDescrição: Erro no processo

Relatório

Por padrão é gerado um relatório com os seguintes campos.
O relatório biométrico pode ser baixado em PDF para auditoria ou backup interno.
Localização no relatório: latitude e longitude dependem da permissão concedida pelo usuário. Se o usuário negar o acesso à localização ou estiver desativada no dispositivo, esses campos não aparecerão no relatório.

Como personalizar a experiência?

Ao clicar no nó Biometria no canvas, um painel lateral abre com três abas de configuração.
Configure a quantidade de tentativas permitidas por etapa do processo biométrico.Variável: Máximo de tentativas na verificação de presençaDescrição: Define quantas vezes o usuário pode tentar a captura facial antes de o processo falhar.Input: 1, 2 ou 3
Variável: Máximo de tentativas na verificação de documentoDescrição: Define quantas vezes o usuário pode tentar capturar o documento.Input: 1, 2 ou 3
Personalize a aparência do WebView que o usuário final verá. Use o botão Pré-visualização para ver o mockup de cada tela antes de publicar.Variável: CoresDescrição: Use as cores da Jelou (padrão) ou defina cores personalizadas para botões, steppers, spinners, fundo e texto.Input: Código de cor em formato HEX (ex.: #1E7A4C)
Variável: Idioma da experiênciaDescrição: Define o idioma padrão da interface que o usuário verá ao iniciar o processo.Input: Espanhol, Inglês ou Português
Variável: Toggle de idiomaDescrição: Um botão é ativado na interface do usuário que permite ao usuário trocar o idioma.Input: Ativado / Desativado.
Defina os níveis mínimos de validação que o usuário deve superar para que o processo seja considerado bem-sucedido.No processo de biometria, os clientes ou usuários podem fazer certas configurações que afetam o desempenho do processo biométrico, ou seja, a performance na taxa de aprovação e rejeição.

Verificação documental

Controla o nível de rigor da análise do documento de identidade. Qual o nível de criticidade necessário para essa validação? Escolha entre três níveis:
Valida os controles básicos do documento:
  • Tipo e origem do documento: identifica o tipo de documento e o país ou entidade emissora, estabelecendo o contexto para as demais validações.
  • Data de vigência: verifica que o documento não está vencido. Se o campo estiver ilegível (baixa resolução, reflexos), o caso pode ser encaminhado para revisão manual em vez de ser rejeitado diretamente.
  • Elementos de segurança físicos: valida hologramas, padrões de fundo e zonas de proteção — barreira contra impressões ou fotocópias de alta resolução.
As variáveis tipo e origem do documento e data de vigência não podem ser desativadas em nenhum nível selecionado.
Inclui tudo do nível Padrão, mais:
  • Resultado global do documento: análise forense completa — coerência visual, consistência entre zonas e padrões de manipulação ou recaptura. Pode determinar a rejeição do documento de forma autônoma.
  • Zona de leitura automática: lê e valida a zona MRZ ou o código de barras do documento, quando o tipo de documento possui essa zona.
  • Coerência de dados do documento: verifica a consistência dos dados extraídos entre as diferentes zonas do documento.
  • Qualidade da foto capturada: avalia nitidez, iluminação e ângulo da captura como sinal de contexto, não de autenticidade.
Em populações com alta presença de documentos antigos ou desgastados, este nível pode aumentar a taxa de encaminhamento para revisão manual (HIL). Avalie a qualidade documental típica da sua base de usuários antes de ativá-lo.
Permite combinar livremente qualquer um dos parâmetros documentais. Essa configuração é aplicada apenas por uma pessoa designada pelo cliente Enterprise e requer coordenação prévia com a Jelou antes de ser habilitada.
As variáveis tipo e origem do documento e data de vigência não podem ser desativadas em nenhum nível selecionado.
Passos para desativar o parâmetro Elementos de segurança físicosEste toggle verifica a presença de hologramas, chips, códigos de barras, etc. Se o seu cliente pedir para desativá-lo, siga estes passos:
  1. Solicite à Jelou: envie o e-mail da pessoa que precisa da desativação e peça a atribuição do papel external_client_biometry para a sua company.
  2. Com o papel ativo, o cliente entra no Brain e desativa a validação diretamente.
  3. Ao desativá-la, o sistema reduz o nível documental para baixo e dispara o modal de consentimento: o cliente deve digitar “conheço e aceito os riscos” para confirmar. Essa aceitação fica registrada para auditoria interna.
Para os países da América Latina que geralmente têm alta presença de documentos antigos ou desgastados, sugerimos uma configuração Personalizada com os seguintes parâmetros:
Ao deixar desativados zona de leitura automática e qualidade da foto capturada, o sistema não exigirá que o documento tenha MRZ nem penalizará se a qualidade da imagem não for alta.

Comparação facial

Variável: Comparação facial (facematch)Descrição: Define o percentual mínimo de similaridade aceito entre a selfie de vivacidade e o rosto extraído do documento.Input: Baixo (65%), Padrão (80%) ou Estrito (90%). O limite é 100% configurável por empresa; o valor padrão é 70%.
Um limite de facematch mais alto reduz o risco de fraude de identidade, mas pode aumentar a rejeição indevida de usuários legítimos. Ajuste o valor conforme o nível de risco aceitável para sua operação.

Validação governamental

Variável: Habilitar validação governamentalDescrição: Este recurso tem custo adicional. Valida os dados extraídos por OCR contra a fonte governamental correspondente. Ao ativá-lo, você deve selecionar o país no qual precisa da validação governamental.Input: Ativado / Desativado + seleção de país

Validação de recaptura

Variável: Habilitar validação de recapturaDescrição: Para uma camada adicional de segurança, você pode ativar o agente de recaptura, baseado em um modelo de linguagem (LLM). Este agente analisa a foto do documento para descartar que se trate de uma foto capturada a partir de uma tela.Input: Ativado / Desativado
Ao ativar este recurso, o nível de análise do documento é mais rigoroso, o que pode: aumentar o tempo total do processo de biometria, aumentar o tempo de carregamento e diminuir a taxa de aprovação quando os documentos apresentarem muitos reflexos ou brilhos causados por luz interna.

URL Termos e condições

Variável: URL Termos e condiçõesDescrição: O usuário deve aceitar os termos na tela inicial antes de iniciar o processo.Input: URL pública (o link deve ser de acesso público)
Esta configuração é global para a sua empresa: qualquer alteração se aplicará a todos os fluxos que usam biometria WebView.

Perguntas frequentes

Fotos do documento de identidade pelos dois lados: frente e verso.
O WebView abre um link dedicado com captura guiada; o relatório inclui dados do dispositivo (navegador, SO, resolução, fuso, IP, ID do dispositivo) e localização se o usuário conceder permissão. Você pode ajustar cores (fundo, texto, botões, stepper), idioma da interface e opções de segurança descritas no guia de personalização; os widgets de captura não são editáveis. O conversacional usa vídeo no chat; o Flows usa foto dentro do WhatsApp Flows com regras próprias de galeria e interface nativa.
Sim: cores de fundo, texto, botões e stepper; idioma da interface (espanhol/inglês) e, quando habilitado, seletor de idioma para o usuário. A cor do stepper também se aplica aos widgets. Os widgets de captura facial e de documento não são personalizáveis.
1 output de sucesso (Biometria aprovada) e 3 outputs de erro (Processo abandonado, Biometria rejeitada, Erro no processo). Cada um pode direcionar para mensagem de texto personalizada ou Connect.
É comum que clientes em fase de testes reportem rejeições em excesso no WebView. Na maioria dos casos, a causa é um nível de análise documental muito rigoroso para o país. Revise a seção Validações e ajuste o nível documental conforme a configuração recomendada por país.
Na etapa de verificação de documento, o sistema identifica o tipo de documento (país, ano de emissão) e o compara com um modelo. Se o documento corresponder e não apresentar sinais de manipulação, ele é aprovado, extraindo os dados por meio de OCR — o que inclui assinatura, foto ghost, retrato, chip (se o documento tiver esse elemento de segurança), etc. Se o elemento que cobre o documento não ocultar informação relevante, ele pode ser aprovado; mas se a validação contra o Registro governamental estiver ativa e os dados estiverem incorretos, a biometria será rejeitada.