Pular para o conteúdo principal
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.

Verificação documental

Controla o nível de rigor da análise do documento de identidade. Escolha entre três níveis:
As variáveis tipo e origem do documento e data de vigência não podem ser desativadas em nenhum nível selecionado.
Em populações com alta presença de documentos antigos ou desgastados, o nível Avançado 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.

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.

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.