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:Acesso via link exclusivo
Tirar uma foto
Capturar o documento de identidade
Comparação facial automática
Como conectar a integração?
Como conectar a integração de Biometria
Abrir a plataforma
Selecionar Biometria
Conectar a integração
Configurar saídas
- Entrada de texto com mensagem personalizada.
- Connect, somente se você tiver este módulo.
Executar testes
Configuração
- Outputs
Sucesso
Biometria aprovada
Biometria aprovada
approvedDescrição: Biometria aprovadaEstrutura da resposta (JSON):document_response: informações do documento de identidadeliveness_response: foto usada na vivacidadefacematch_response: resultado da comparação facialreporte_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)
- 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
Processo abandonado
Processo abandonado
incompleteDescrição: Processo abandonadoBiometria rejeitada
Biometria rejeitada
rejectDescrição: Biometria rejeitadaErro no processo
Erro no processo
errorDescrição: Erro no processoRelatório
Por padrão é gerado um relatório com os seguintes campos.Campos do relatório
Campos do 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.Geral
Geral
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
Experiência
Experiência
#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.
Validações
Validações
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:Padrão
Padrão
- 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.
Avançado
Avançado
- 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.
Personalizado
Personalizado
Configuração recomendada por país
Configuração recomendada por país
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%.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ísValidaçã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 / DesativadoURL 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)Perguntas frequentes
Quais imagens de documento são necessárias durante o processo biométrico?
Quais imagens de documento são necessárias durante o processo biométrico?
Como a biometria WebView difere de Flows ou conversacional?
Como a biometria WebView difere de Flows ou conversacional?
Posso personalizar cores e idioma da interface?
Posso personalizar cores e idioma da interface?
Quantos outputs este agente tem?
Quantos outputs este agente tem?
O que acontece se eu estiver tendo muitos documentos rejeitados?
O que acontece se eu estiver tendo muitos documentos rejeitados?
Se eu cobrir parte do documento que contém informação relevante, a verificação de documento ainda assim aprova?
Se eu cobrir parte do documento que contém informação relevante, a verificação de documento ainda assim aprova?