Versão: use sempre a versão mais recente disponível. Esta primeira versão não tem acesso ao serviço HIL (Human in the Loop).
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: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.
Tirar uma foto
O usuário captura uma foto ao vivo pela câmera, com guias visuais para uma captura correta.
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.
Conectar pelo Marketplace
Abrir a plataforma
Acesse apps.jelou.ai.
Na tela inicial você verá Brain Studio e Connect. No Brain Studio, selecione Marketplace.
Conectar a integração
Pesquise KYC e clique em Conectar.
Se sua organização estiver no plano Free, verá o CTA para fazer upgrade para Builder (o KYC está disponível a partir do plano Builder).
Se aparecer Conectar e você clicar, o canvas de trabalho do Brain será aberto.
Configuração inicial
- Depois de arrastar a integração para o canvas e clicar, selecione a ferramenta nativa desejada:
- Conversacional → Validação com vídeo
- WebView → Validação com foto (WebView)
- Flows → Validação com foto (Flows)
- A versão é exibida por padrão como a mais recente disponível.
Configurar outputs
Este agente tem 1 output de sucesso e 3 outputs de erro. Cada um pode direcionar para:
- Entrada de texto com mensagem personalizada.
- Connect, somente se você tiver este módulo.
Neste agente o link de termos e condições fica dentro do WebView na interface. Você deve integrar o link público dos termos e condições aplicáveis.
Configuração
- Outputs
Sucesso
Biometria aprovada
Biometria aprovada
Confirma que a verificação biométrica foi bem-sucedida.Variável: Campos importantes:
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
O usuário saiu do processo antes de concluir.Variável:
incompleteDescrição: Processo abandonadoBiometria rejeitada
Biometria rejeitada
A verificação biométrica falhou ou foi rejeitada.Variável:
rejectDescrição: Biometria rejeitadaErro no processo
Erro no processo
Erro durante a execução do processo biométrico.Variável:
errorDescrição: Erro no processoRelatório
Por padrão é gerado um relatório com os seguintes campos:| Campo | Descrição |
|---|---|
| Código biométrico | ID único do processo |
| Data e hora | Timestamp da verificação |
| Resultado biométrico | Aprovado / Não aprovado |
| Número de identificação | Documento do usuário |
| Tipo de identificação | Tipo de documento |
| Primeiros nomes | Primeiros nomes do usuário |
| Sobrenomes | Sobrenomes do usuário |
| Celular | Telefone |
| Foto | URL do selfie |
| Resultado da vivacidade | Aprovado / Não aprovado |
| Foto frontal do documento | URL |
| Foto do verso do documento | URL |
| Resultado da verificação do documento | Aprovado / Não aprovado |
| Foto do rosto no documento | URL |
| Resultado do facematch | Percentual de correspondência |
| Relatório biométrico | URL do relatório |
| Descrição da falha | Detalhe do erro |
| Observações | Observações adicionais |
| User agent | String user agent do navegador |
| Navegador | Navegador (ex.: Chrome) |
| Sistema operacional | SO do dispositivo |
| Plataforma | Plataforma (ex.: Linux aarch64) |
| Idioma | Idioma configurado (ex.: es-US) |
| Fuso horário | Fuso (ex.: America/Guayaquil) |
| Resolução da tela | Resolução (ex.: 376x835) |
| Profundidade de cor | Profundidade em bits |
| Timestamp (dispositivo) | Timestamp do dispositivo |
| Endereço IP | IP usado na verificação |
| Latitude | Latitude da localização |
| Longitude | Longitude da localização |
| ID do dispositivo | ID único do dispositivo |
| Nome do dispositivo | Nome (ex.: Linux - Chrome) |
O relatório biométrico pode ser baixado em PDF para auditoria ou backup interno.
Personalização
No WebView, a personalização da interface permite alterar:- Cor de fundo
- Cor do texto
- Cor dos botões
- Cor do stepper
- Widgets de captura facial
- Widgets de captura de documento
Para detalhes completos sobre personalização da interface, termos legais e controles de segurança adicionais, veja Personalização do WebView.
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?
Fotos do documento de identidade pelos dois lados: frente e verso.
Como a biometria WebView difere de Flows ou conversacional?
Como a biometria WebView difere de Flows ou conversacional?
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.
Posso personalizar cores e idioma da interface?
Posso personalizar cores e idioma da interface?
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.
Quantos outputs este agente tem?
Quantos outputs este agente tem?
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.