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

Conectar pelo Marketplace

1

Abrir a plataforma

Acesse apps.jelou.ai. Na tela inicial você verá Brain Studio e Connect. No Brain Studio, selecione Marketplace.
2

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.
3

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.
4

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.
5

Executar testes

Com a configuração que você acabou de definir, execute testes com o botão Teste.
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

Sucesso

Confirma que a verificação biométrica foi bem-sucedida.Variável: approvedDescrição: Biometria aprovadaEstrutura da resposta (JSON):
{
  "document_response": {
    "document_check": {
      "result": "",
      "verified_fields": { "...": "Dados principais do documento" },
      "secondary_fields": { "...": "Dados secundários do documento" },
      "details": { "...": "Detalhes do tipo de documento" },
      "status_fields": { "...": "Status da validação" },
      "image_quality_details": { "...": "Detalhes de qualidade da imagem" },
      "images_extracted": { "...": "Imagens extraídas do documento" },
      "gov_entity_fields": { "document_number": "Número do documento de identidade" }
    },
    "document_image_front_url": "URL da imagem frontal do documento",
    "document_image_back_url": "URL da imagem do verso do documento",
    "document_face_image_url": "URL da imagem do rosto extraída do documento"
  },
  "liveness_response": {
    "result": "true",
    "url_selfie_image": "URL da foto usada para vivacidade"
  },
  "facematch_response": {
    "facematch_result": "approved",
    "facematch_confidence": "Percentual de correspondência (0-100)"
  },
  "reporte_de_biometria": {
    "report": "URL do relatório biométrico (web)",
    "report_pdf": "URL do relatório biométrico (PDF)"
  },
  "device_info": {
    "userAgent": "String user agent",
    "browser": "Navegador",
    "operatingSystem": "Sistema operacional",
    "platform": "Plataforma do dispositivo",
    "language": "Idioma",
    "timezone": "Fuso horário",
    "screenResolution": "Resolução da tela",
    "colorDepth": "Profundidade de cor em bits",
    "timestamp": "Timestamp do dispositivo",
    "ipAddress": "Endereço IP",
    "location": {
      "latitude": "Latitude (se o usuário conceder permissão)",
      "longitude": "Longitude (se o usuário conceder permissão)"
    },
    "deviceId": "ID único do dispositivo",
    "deviceName": "Nome do dispositivo"
  },
  "gov_entity_data": {
    "...": "Dados da entidade governamental do país (varia por país)"
  }
}
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:
CampoDescrição
Código biométricoID único do processo
Data e horaTimestamp da verificação
Resultado biométricoAprovado / Não aprovado
Número de identificaçãoDocumento do usuário
Tipo de identificaçãoTipo de documento
Primeiros nomesPrimeiros nomes do usuário
SobrenomesSobrenomes do usuário
CelularTelefone
FotoURL do selfie
Resultado da vivacidadeAprovado / Não aprovado
Foto frontal do documentoURL
Foto do verso do documentoURL
Resultado da verificação do documentoAprovado / Não aprovado
Foto do rosto no documentoURL
Resultado do facematchPercentual de correspondência
Relatório biométricoURL do relatório
Descrição da falhaDetalhe do erro
ObservaçõesObservações adicionais
User agentString user agent do navegador
NavegadorNavegador (ex.: Chrome)
Sistema operacionalSO do dispositivo
PlataformaPlataforma (ex.: Linux aarch64)
IdiomaIdioma configurado (ex.: es-US)
Fuso horárioFuso (ex.: America/Guayaquil)
Resolução da telaResolução (ex.: 376x835)
Profundidade de corProfundidade em bits
Timestamp (dispositivo)Timestamp do dispositivo
Endereço IPIP usado na verificação
LatitudeLatitude da localização
LongitudeLongitude da localização
ID do dispositivoID único do dispositivo
Nome do dispositivoNome (ex.: Linux - Chrome)
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.

Personalização

No WebView, a personalização da interface permite alterar:
  • Cor de fundo
  • Cor do texto
  • Cor dos botões
  • Cor do stepper
Ao definir a cor do stepper, essa mesma cor se aplica aos widgets. Não são personalizáveis:
  • Widgets de captura facial
  • Widgets de captura de documento
Isso mantém a qualidade da verificação consistente.
Para detalhes completos sobre personalização da interface, termos legais e controles de segurança adicionais, veja Personalização do 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.