Agente de Verificação de Presença

Versão: sempre use a versão mais recente disponível.

O Agente de Verificação de Presença é projetado para garantir que a pessoa por trás da tela seja uma pessoa viva e esteja presente durante o processo, sem precisar sair do chat. Recomenda-se usar este agente quando você precisa apenas validar a presença de uma pessoa. Este agente pode ser usado em qualquer país.

Isso não é considerado um processo biométrico completo.

Pré-requisitos

✅ Checklist para começar sem bloqueios

O usuário deve ser capaz de gravar vídeo pelo chat (as permissões de câmera devem estar habilitadas no dispositivo).
Recomendado: defina o fluxo de atendimento caso habilite o Human in the loop (quem revisa, tempos de resposta e o que acontece se não houver resposta).

Quais etapas o usuário conclui?

Ler as instruções

O usuário vê uma mensagem no chat com os passos a seguir para gravar um vídeo e uma imagem com instruções para uma gravação adequada.

Gravar um vídeo selfie

O usuário grava um vídeo curto no qual deve mencionar uma sequência numérica única (OTP).

Comunicação constante

O usuário recebe mensagens indicando que seu vídeo está sendo analisado: “Estamos verificando seu vídeo. Isso levará apenas alguns segundos.” Se a análise for bem-sucedida, verá “Sua verificação de presença foi bem-sucedida.” Se a análise encontrar erros: “Tivemos um problema ao analisar o vídeo. Por favor, tente o processo novamente.”

Como o agente é composto?

O agente contém ferramentas que analisam o vídeo enviado pelo usuário:

Geração de OTP: gera a sequência numérica que o usuário deve dizer ao gravar o vídeo.
Fala para texto: converte o áudio em texto para comparar se corresponde ao código emitido.
Validação de OTP: valida que o código mencionado está correto.
Validação de presença passiva: valida a presença da imagem extraída do vídeo enviado pelo usuário. Este processo identifica e neutraliza deepfakes ou qualquer tentativa de personificação, garantindo a presença de um rosto de pessoa viva.
Validação de lipsync (opcional): valida que o áudio do vídeo corresponde ao vídeo, comparando a frequência de áudio com a frequência do vídeo para confirmar que pertencem à mesma fonte.
Human in the Loop (somente enterprise): se o processo falhar, você pode optar pelo Human in the Loop (HIL), onde o caso será revisado por um operador humano.

Conexão pelo Marketplace

Acesse a plataforma

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

Encontre o agente no Marketplace

No Marketplace você verá três abas: Catálogo, Instalados e Desenvolvedores. Clique em Desenvolvedores e use a barra de pesquisa para encontrar o Liveness check agent. Em seguida, clique no ícone de download para instalá-lo.

Confirme a instalação

Se a instalação foi concluída com sucesso, você verá a tag Instalado em verde.

Abra o agente no Brain

Vá para o Brain. Na barra lateral você verá suas skills e ferramentas instaladas. Pesquise pelo Liveness check agent e clique para abri-lo: o fluxo será carregado no seu canvas.

Configure a versão e as entradas

Clique no nó de entrada, abra as Configurações avançadas (na parte inferior) e selecione a versão do agente. Se você usar os valores padrão, não precisa modificar as entradas. Se for alterar alguma entrada ou personalizar mensagens, revise a seção de Configuração.

Configure as saídas

Este agente tem 5 saídas de erro e 1 saída de sucesso. Você pode direcionar cada saída para:

Uma entrada de texto com uma mensagem personalizada.
Connect (somente se sua organização tiver este módulo).

Execute testes

Com a configuração pronta, execute testes usando uma skill ou um agente anterior como “precursor” para acionar o fluxo.

Configuração

Entradas
Saídas

Idioma

string

padrão:"Es"

Variável: language. Define o idioma da experiência.Valores disponíveis: Es (Espanhol), En (Inglês)

Máx. tentativas de verificação de presença

number

padrão:"3"

Variável: retries. Número máximo de tentativas de verificação de presença.Valores disponíveis: 1-5

Email de notificação para tentativas excedidas

string

Variável: customerServiceEmail. Email a ser notificado quando o número máximo de tentativas for excedido.

Habilitar Vídeo de Introdução de Presença

boolean

padrão:"false"

Variável: enableIntroVideo. Determina se o vídeo de introdução deve ser mostrado ao usuário antes de iniciar o processo.

URL para exibir mídia de introdução de presença

string

Variável: introMediaUrl. A URL fornecida ao usuário para carregar um vídeo ou imagem de introdução que será usado no processo.

Quantidade de dígitos do código OTP no Chat

Comprimento do código OTP no Chat

number

padrão:"4"

Variável: otpLength. Número de dígitos no código OTP.Valores disponíveis: 3-6

Duração máxima do código OTP

number

padrão:"1"

Variável: otpDuration. Duração máxima do código OTP, em minutos.Valores disponíveis: 1-10

Habilitar Human in the loop

boolean

padrão:"false"

Variável: enableHumanInLoop. Esta variável indica se o processo de revisão com um agente humano deve ser ativado.

Habilitar LipSync

boolean

padrão:"false"

Variável: enableLipSync. Habilite o LipSync para comparação do movimento labial com o áudio.

Máx. tentativas do agente

string

padrão:"Unlimited"

Variável: retriesAgent. Número máximo de tentativas do agente antes de bloquear o usuário.Valores disponíveis: Unlimited, 1, 2, 3

Duração do bloqueio do usuário

string

padrão:"1 day"

Variável: blockingInHours. Duração do bloqueio quando o limite de tentativas do agente é excedido.Valores disponíveis: 1 day, 1 week, 1 month

Habilitar mensagens personalizadas

boolean

padrão:"false"

Variável: enableCustomMessages. Habilite mensagens personalizadas.

Mensagens de fala para texto

Variável: speechToTextMessages. Mensagens personalizadas para erros de transcrição de áudio.Formato JSON:

{
  "no_text": {
    "description": "When you recorded the video selfie we could not capture the sound of your voice. You may be in a very noisy place, or you sent a video without sound.",
    "advice": "Try again, making sure the video selfie has sound."
  },
  "error_http": {
    "description": "We're sorry, there was an error in the audio transcription.",
    "advice": "Try again, making sure the video selfie has sound."
  },
  "error_code": {
    "description": "We're sorry, there was an error in the audio transcription.",
    "advice": "Try again, making sure the video selfie has sound."
  }
}

Mensagens de validação OTP

Variável: OTPValidationMessages. Mensagens personalizadas para erros de validação de OTP.Formato JSON:

{
  "client_error": {
    "description": "⚠️ The numeric sequence you mentioned is *[transcription]*, and it is not correct.",
    "advice": "Try again, making sure the numeric sequence is correct."
  },
  "OTP_ERROR": {
    "description": "⚠️ We're sorry, you exceeded the time limit for us to validate your video selfie.",
    "advice": "Try again, making sure the numeric sequence is correct."
  },
  "CODE_ERROR": {
    "description": "We're sorry, an unexpected error occurred in the service.",
    "advice": "Try again, making sure the numeric sequence is correct."
  },
  "HTTP_ERROR": {
    "description": "We're sorry, an unexpected error occurred in the service.",
    "advice": "Try again, making sure the numeric sequence is correct."
  }
}

Mensagens de presença passiva

Variável: passiveLivenessMessages. Mensagens personalizadas para erros de presença passiva.Formato JSON:

{
  "resp_face": {
    "description": "We're sorry! We analyzed your video and *could not detect any face*.",
    "advice": "Try again, making sure the video selfie has a visible face."
  },
  "more_than_one_face": {
    "description": "We're sorry! We analyzed your video and *detected more than one face*.",
    "advice": "Try again, making sure the video selfie has only one visible face."
  },
  "face_far": {
    "description": "We're sorry! We analyzed your video and found that *your face was a little far from the camera*.",
    "advice": "Try again, making sure the video selfie has your face facing the camera."
  },
  "face_close": {
    "description": "We're sorry! We analyzed your video and it appears *you moved your face too close to the camera and a complete image could not be captured*.",
    "advice": "Try again, making sure the video selfie has your face facing the camera."
  },
  "face_cut_covered": {
    "description": "We're sorry! We analyzed your video and *it seems your face was covered or you were not well centered to the camera*.",
    "advice": "Try again, making sure the video selfie has your face facing the camera."
  },
  "eyes_closed": {
    "description": "We're sorry! We analyzed your video and could not detect your eyes well, it seems *you were wearing glasses or your eyes were slightly closed*.",
    "advice": "Try again, making sure the video selfie has your eyes open."
  },
  "low_quality": {
    "description": "We're sorry! The video we received is low quality and we could not process it correctly.",
    "advice": "Try again, making sure the video selfie has adequate quality."
  },
  "code_error": {
    "description": "We're sorry, an unexpected error occurred in the service.",
    "advice": "Try again, making sure the video selfie has adequate quality."
  },
  "error_http": {
    "description": "We're sorry, an unexpected error occurred in the service.",
    "advice": "Try again, making sure the video selfie has adequate quality."
  },
  "error_general": {
    "description": "We're sorry, an unexpected error occurred in the service.",
    "advice": "Try again, making sure the video selfie has adequate quality."
  }
}

Habilitar instruções

boolean

padrão:"true"

Variável: enableInstructions. As instruções em uma imagem estão habilitadas por padrão.

✅ Sucesso

Verificação de presença bem-sucedida

A verificação de presença foi concluída com sucesso.Variável: livenessSuccess

Para acessar as informações nesta variável, use o comando $memory.get("response_liveness_success")

Exemplo de resposta:

{
  "response_liveness_success": {
    "url_video_liveness": "URL of the video sent by the user",
    "url_selfie_image": "URL of the frame obtained from the video to validate the user's liveness"
  }
}

Campos importantes:

url_video_liveness: URL do vídeo selfie enviado pelo usuário
url_selfie_image: URL da imagem extraída do vídeo para validar a presença

Informações salvas na Memória:O agente salva automaticamente as seguintes informações em variáveis de memória:

{
  "livenessSuccess": true,
  "response_liveness_success": {
    "url_video_liveness": "https://cdn.jelou.ai/whatsapp_...",
    "url_selfie_image": "https://cdn.jelou.ai/video-fra..."
  }
}

Variáveis disponíveis:

$memory.livenessSuccess: Indica se a verificação de presença foi bem-sucedida (true) ou não (false)
$memory.response_liveness_success: Objeto com as URLs do vídeo e da imagem extraída

Você pode acessar essas informações em qualquer ponto do fluxo usando $memory.get("livenessSuccess") ou $memory.get("response_liveness_success").

🔴 Erros

Tempo Expirado

O tempo para concluir o processo expirou.Variável: timeExpiredError

Erro de serviço

Ocorreu um erro no processo de detecção da presença do usuário.Variável: serviceError

Processo Abandonado

O usuário abandonou o processo.Variável: userExitProcess

Verificação de presença malsucedida

A presença do usuário não pôde ser detectada.Variável: livenessError

Usuário Bloqueado

Usuário Bloqueado.Variável: userBlocked

Perguntas frequentes

Este agente é considerado um processo biométrico?

Não, o processo de verificação de presença é apenas uma “etapa” do processo biométrico, portanto não é considerado biometria facial.

Quais documentos são necessários durante a interação do processo de verificação de presença?

Nenhum. A única entrada é o vídeo selfie que o usuário grava com seu telefone.

Posso habilitar um vídeo de instrução?

Sim, você pode habilitar o vídeo de instrução na entrada Habilitar Vídeo de Introdução de Presença (true). As instruções em uma imagem estão habilitadas por padrão.

Posso adicionar minha própria mídia de instrução?

Sim, você pode adicionar seu próprio link de instrução na entrada URL para exibir mídia de introdução de presença, desta forma a imagem ou vídeo padrão é desabilitado.

Se o usuário iniciou seu processo biométrico mas não o concluiu, quanto tempo antes do processo fechar? O usuário pode retomar o processo biométrico do ponto onde parou?

O processo fecha quando passa 1 hora sem atividade no chat. Se o usuário retornar ao chat, deve iniciar o fluxo desde o início.

Primeiros Passos

Agentes de IA

Brain

Nós

Bases de Dados

Variáveis

Ferramentas

Funções

Configuração

Marketplace

Enterprise

Faturamento

Agente de Verificação de Presença

Pré-requisitos

✅ Checklist para começar sem bloqueios

Quais etapas o usuário conclui?

Como o agente é composto?

Conexão pelo Marketplace

Configuração

✅ Sucesso

🔴 Erros

Perguntas frequentes

Primeiros Passos

Agentes de IA

Brain

Nós

Bases de Dados

Variáveis

Ferramentas

Funções

Configuração

Marketplace

Enterprise

Faturamento

​Pré-requisitos

​✅ Checklist para começar sem bloqueios

​Quais etapas o usuário conclui?

​Como o agente é composto?

​Conexão pelo Marketplace

​Configuração

​✅ Sucesso

​🔴 Erros

​Perguntas frequentes

Pré-requisitos

✅ Checklist para começar sem bloqueios

Quais etapas o usuário conclui?

Como o agente é composto?

Conexão pelo Marketplace

Configuração

✅ Sucesso

🔴 Erros

Perguntas frequentes