Insoft QFace App - Documentação - Parte 2

Gilberto Júnior

Visualizando os Logs do Sistema

O que é:

Os logs são registros de todas as atividades do sistema. São úteis para entender o que aconteceu, quando aconteceu e identificar possíveis problemas.

️ Como ver os logs:

Acesse o Dashboard
Na parte inferior da tela, localize o bloco "Preview do Log"
Clique nele para expandir o visualizador de logs
Na janela expandida:
- À esquerda: lista de arquivos de log (organizados por data)
- À direita: conteúdo do arquivo selecionado

️ Como navegar entre arquivos de log:

No visualizador de logs expandido, clique no arquivo desejado na lista da esquerda
O conteúdo aparecerá automaticamente à direita
Os arquivos mais recentes aparecem primeiro (no topo da lista)

Como interpretar as cores nos logs:

Cor	Significado
Azul	Data e hora do registro
🟢 Verde	Informação (tudo ok)
Vermelho	Erro (algo deu errado)

5. FLUXOS COMUNS DO DIA A DIA

Fluxo 1: Verificar se o sistema está funcionando

Objetivo: Confirmar que tudo está operacional antes de iniciar as atividades do dia.

️ Passo a passo:

Abra o Insoft QFace App
Vá para o Dashboard
Verifique o cartão "Status da API":
- Se mostrar "Online" (badge verde): sistema funcionando, pode seguir normalmente
- Se mostrar "Parado" (badge vermelho): vá para o passo 4
Clique no cartão "Status da API" para ir à Gestão da API
Clique em " Iniciar"
Aguarde a confirmação de sucesso
Volte ao Dashboard e verifique se agora aparece "Online"

Fluxo 2: Iniciar o sistema pela manhã

Objetivo: Preparar o sistema para o expediente.

️ Passo a passo:

Ligue o computador normalmente
Abra o Insoft QFace App

Se o serviço foi instalado como serviço Windows, a API já pode estar rodando automaticamente!
Verifique o Dashboard — se a API estiver "Online" e o dispositivo QFace "Conectado", está pronto!
Se a API estiver "Parado", acesse API → Gestão da API e clique em " Iniciar"
Se o dispositivo QFace estiver "Desconectado", acesse Gestão QFace e clique em " Reconectar"

Fluxo 3: Acompanhar uma conversão de fotos em andamento

Objetivo: Monitorar o cadastro biométrico de um lote de colaboradores.

️ Passo a passo:

O sistema externo (ERP, sistema de ponto, etc.) inicia o envio de fotos
O Insoft QFace App abre automaticamente a tela de Conversão de Fotos
Observe os cartões na tela — cada um representa um colaborador:
- Aguardando (cinza): ainda não foi processado
- Sucesso (verde): foto convertida com sucesso
- Erro (vermelho): houve problema com essa foto
Aguarde até todos os cartões mostrarem o resultado final
Se houver erros, anote os IDs dos colaboradores com problema e informe ao responsável

Fluxo 4: Acompanhar uma captura ao vivo

Objetivo: Auxiliar na captura de foto de um colaborador pelo leitor QFace.

️ Passo a passo:

O sistema externo solicita a captura
O Insoft QFace App abre automaticamente a tela de Captura de Fotos
Oriente o colaborador a:
- Se posicionar em frente ao leitor QFace
- Olhar diretamente para o leitor
- Ficar parado durante a contagem
Observe a contagem regressiva na tela (5, 4, 3, 2, 1...)
O leitor captura o rosto automaticamente
Verifique o resultado da qualidade:
- 🟢 Qualidade Excelente / Razoável: captura concluída com sucesso
- Qualidade muito baixa: a captura será solicitada novamente pelo sistema

Fluxo 5: Alterar configurações e aplicar mudanças

Objetivo: Modificar alguma configuração e garantir que ela seja aplicada.

️ Passo a passo:

Acesse Configurações no menu lateral
Navegue pela aba desejada
Realize as alterações necessárias
Clique em " Salvar Configurações"
Se aparecer um aviso amarelo "Reiniciar API para aplicar as alterações":
- Clique em "Reiniciar API" (botão no aviso) OU
- Vá para API → Gestão da API e clique em " Reiniciar"
Aguarde a confirmação de que a API foi reiniciada com sucesso

Fluxo 6: Consultar histórico de atividades

Objetivo: Verificar o que aconteceu no sistema em determinado período.

️ Passo a passo:

Acesse o Dashboard
Clique no bloco de "Preview do Log"
Na janela de logs, escolha o arquivo de log pelo nome (geralmente contém a data)
Leia as entradas mais recentes (aparecem na parte inferior do conteúdo)
Procure por entradas em vermelho para identificar possíveis erros

️ 6. ERROS COMUNS E COMO RESOLVER

Problema 1: A API aparece como "Parado" ou "Offline" no Dashboard

Possíveis causas:

O serviço da API não foi instalado ainda
O serviço foi parado manualmente
O computador foi reiniciado e o serviço não inicia automaticamente

Como resolver:

Vá para API → Gestão da API
Verifique a linha "Serviço Windows":
- Se mostrar "✗ Não Instalado": clique em " Instalar Serviço Windows" e aguarde
- Se mostrar "✓ Instalado" mas o estado for "Stopped": clique em " Iniciar"
Aguarde alguns segundos e verifique se o status muda para "🟢 Em Execução"
Se não resolver, volte ao Dashboard para confirmar se agora aparece "Online"

Problema 2: Leitor QFace aparece como "Desconectado"

Possíveis causas:

O leitor QFace está desligado ou sem energia
O cabo de rede do leitor foi desconectado
O endereço de rede (IP) do leitor mudou
O computador e o leitor estão em redes diferentes

Como resolver:

Verifique fisicamente se o leitor QFace está ligado (deve ter luzes acesas)
Verifique se o cabo de rede do leitor está conectado corretamente
Vá para Gestão QFace e clique em " Reconectar"
Se ainda não conectar, acesse Configurações → Aba QFace e verifique se a Porta do Dispositivo está correta
Se o problema persistir, acione o suporte técnico informando que o leitor não está acessível pela rede

Problema 3: Conversão de fotos falha com erro

Possíveis causas:

A foto enviada não contém um rosto humano visível
A foto está com qualidade muito baixa (escura, borrada, muito pequena)
O leitor QFace estava desconectado no momento da conversão
A foto enviada não é um arquivo de imagem válido (JPEG ou PNG)

Como resolver:

Veja na tela de Conversão quais colaboradores tiveram erro
Anote os IDs dos colaboradores com problema
Informe ao responsável que enviou as fotos para verificar:
- A foto deve ter o rosto frontal e bem iluminado
- A imagem deve ter boa resolução (pelo menos 200x200 pixels)
- O formato deve ser JPEG ou PNG
- Não pode haver objetos cobrindo o rosto (óculos escuros, máscara, chapéu)
Após corrigir as fotos, o sistema externo pode reenviar apenas os colaboradores com erro

Problema 4: Captura ao vivo não funciona / tela preta na câmera

Possíveis causas:

O Windows bloqueou o acesso à câmera para este aplicativo
O driver da câmera do leitor QFace não está instalado corretamente
Outro programa está usando a câmera ao mesmo tempo

Como resolver:

Acesse Configurações no menu lateral
Procure por um botão ou link "Abrir Configurações de Câmera"
Na janela do Windows que abrir, certifique-se que a opção "Permitir que aplicativos acessem sua câmera" está ativada
Feche outros programas que possam estar usando a câmera (como Skype, Teams, Zoom)
Feche e reabra o Insoft QFace App
Se o problema persistir, contate o suporte técnico para reinstalação dos drivers

Problema 5: Não consigo instalar o serviço — erro de permissão

Possíveis causas:

O aplicativo não está sendo executado com permissões de administrador
O antivírus do computador está bloqueando a instalação

Como resolver:

Feche o Insoft QFace App
Clique com o botão direito no ícone do programa na área de trabalho
Selecione "Executar como Administrador"
Clique em "Sim" na janela de permissão do Windows
Tente instalar o serviço novamente
Se ainda falhar, comunique ao setor de TI que o antivírus pode estar bloqueando a ação

Problema 6: A captura ao vivo foi encerrada com "Tempo limite atingido"

O que aconteceu:

O sistema aguarda um tempo máximo para o colaborador posicionar o rosto na câmera. Se esse tempo acabar sem uma captura bem-sucedida, a operação é cancelada.

Como resolver:

O sistema externo precisará solicitar a captura novamente
Desta vez, certifique-se de que o colaborador esteja posicionado na frente do leitor antes da contagem regressiva terminar
Garanta que o ambiente esteja bem iluminado e sem objetos bloqueando o rosto

Problema 7: Configurações salvas mas não surtiram efeito

Possível causa:

Algumas configurações exigem que a API seja reiniciada para serem aplicadas.

Como resolver:

Após salvar as configurações, verifique se apareceu um aviso pedindo para reiniciar a API
Vá para API → Gestão da API
Clique em " Reiniciar"
Aguarde a confirmação e teste novamente

7. PERGUNTAS FREQUENTES (FAQ)

O programa precisa ficar aberto o tempo todo?

Não necessariamente. Se o serviço da API foi instalado como Serviço Windows (botão " Instalar Serviço Windows"), a API continuará funcionando mesmo com o aplicativo fechado. O aplicativo Insoft QFace App só precisa estar aberto quando você quiser monitorar o sistema, alterar configurações ou acompanhar capturas ao vivo.

O que acontece se eu fechar o programa durante uma conversão?

Se a conversão foi iniciada por um sistema externo e a API está rodando como serviço Windows, a conversão continuará normalmente em segundo plano. O aplicativo só exibe o progresso — não é ele que realiza a conversão.

O sistema funciona sem internet?

Sim! O Insoft QFace App funciona completamente offline, em rede local. Ele se comunica com o leitor QFace pela rede interna da empresa. Conexão com internet só seria necessária se houver uma API externa configurada em outro servidor fora da rede local.

Posso usar o programa em mais de um computador ao mesmo tempo?

O programa deve ser instalado e executado no mesmo computador onde o serviço de API está instalado. Múltiplos computadores podem acessar a API através de outros sistemas integrados, mas o aplicativo Insoft QFace App em si é para uso local.

Como sei se o leitor QFace está funcionando corretamente?

Acesse Gestão QFace e verifique se aparece "Conectado" (badge verde). Se quiser confirmar que ele está respondendo, clique em "🧪 Testar". Se o teste for bem-sucedido, o leitor está operacional.

O que é o "template biométrico"?

É uma representação digital do rosto de uma pessoa — um conjunto de dados que descreve as características únicas do rosto, como a distância entre os olhos, o contorno do queixo, etc. Não é uma foto — é um código matemático que pode ser usado para identificação, mas que não permite "reconstruir" a foto original. É mais seguro e ocupa muito menos espaço que uma imagem.

As fotos dos colaboradores ficam salvas no programa?

Sim, caso a opção "Salvar Imagens" esteja ativada nas Configurações (aba Avançado), as fotos processadas ficam salvas em uma pasta no computador. Os templates biométricos também podem ser salvos conforme a configuração. Para alterar esse comportamento, acesse Configurações → Aba Avançado.

Por quanto tempo os registros ficam salvos?

Por padrão, os registros são mantidos por 7 dias. Você pode alterar esse prazo em Configurações → Aba Avançado → "Dias de Retenção".

Posso mudar o tema do programa para fundo escuro (modo noturno)?

Sim! Acesse Configurações → Aba Geral e selecione o tema " Escuro". A mudança é aplicada imediatamente, sem precisar salvar ou reiniciar.

O que significa "Start Pending" ou "Stop Pending" no status do serviço?

Significa que o serviço está no meio de um processo:

Start Pending: a API está sendo iniciada (aguarde alguns segundos)

Stop Pending: a API está sendo encerrada (aguarde alguns segundos)
Esses estados são temporários. Aguarde e o status se atualizará automaticamente.

Posso ter mais de um leitor QFace conectado?

Na configuração atual, o sistema se conecta a um leitor QFace por vez, identificado pelo endereço configurado em Configurações → Aba QFace.

🧠 8. DICAS IMPORTANTES

Boas práticas de uso

Verifique o Dashboard diariamente no início do expediente para garantir que tudo está operacional
Instale o serviço como Serviço Windows — isso garante que a API inicie automaticamente com o computador, sem necessidade de intervenção manual toda manhã
Reinicie a API após alterar configurações — algumas configurações só são aplicadas após reiniciar
Mantenha os logs em dia — consulte os logs regularmente para identificar problemas antes que se tornem graves
Não feche o aplicativo durante capturas ao vivo — embora a API continue funcionando, a tela de captura precisa estar aberta para concluir o processo

O que evitar

Não pare a API durante uma conversão ou captura em andamento — isso pode causar erros e deixar o sistema em estado inconsistente
Não altere manualmente os arquivos de configuração — use sempre a tela de Configurações do aplicativo
Não instale o serviço duas vezes — se já estiver instalado, o botão de instalação não aparecerá. Se precisar reinstalar, remova primeiro e depois instale novamente
Não ignore mensagens de erro — elas contêm informações importantes sobre o que precisa ser corrigido
Não tente usar dois programas que acessem a câmera ao mesmo tempo — isso causará conflito e a captura falhará

Como usar melhor o sistema

Use o tema Escuro para uso prolongado — reduz a fadiga visual
Mantenha o leitor QFace sempre ligado durante o expediente para evitar atrasos quando uma conversão ou captura for solicitada
Oriente os colaboradores sobre como se posicionar corretamente na frente do leitor QFace antes de realizar capturas
Acesse os logs sempre que algo parecer errado — eles contêm os detalhes do que aconteceu
Anote o IP do leitor QFace em um local seguro — se o leitor for trocado ou reinstalado, você precisará dessa informação para reconfigurar o sistema

9. SUPORTE

Quando procurar suporte técnico?

Procure o suporte técnico da Insoft4 Informática quando:

A API não inicia mesmo após tentar os passos de resolução deste guia
O leitor QFace nunca conecta, mesmo com o equipamento ligado e na rede
Erros aparecem repetidamente sem causa aparente
O programa apresenta comportamento estranho ou trava com frequência
Você precisar reinstalar o sistema completo
Precisar configurar o sistema em um novo computador

Informações que você deve ter em mãos ao contatar o suporte

Para agilizar o atendimento, tenha disponível as seguintes informações:

Informação	Onde encontrar
Versão do sistema	Tela inicial do aplicativo (canto inferior)
Sistema Operacional	Windows → Configurações → Sistema → Sobre
Mensagem de erro exata	Copie o texto do erro exatamente como aparece
Conteúdo dos logs	Dashboard → Preview do Log → expandir → copiar conteúdo
IP e porta do leitor QFace	Configurações → Aba QFace
Status da API	API → Gestão da API (captura de tela ajuda)
Quando o problema começou	Data e hora aproximadas
O que foi feito antes do problema	Descreva o que estava sendo feito

Onde ficam os arquivos de log?

Os arquivos de log ficam salvos automaticamente na pasta de instalação do programa. Eles podem ser solicitados pelo suporte técnico para análise. Para acessá-los diretamente pelo aplicativo, use o Dashboard → Preview do Log → expandir.

Este guia foi elaborado para ajudá-lo a usar o Insoft QFace App com confiança e autonomia.
Em caso de dúvidas não cobertas por este material, entre em contato com o suporte técnico da Insoft4 Informática LTDA.

Guia do Usuário — Insoft QFace App v1.0.0 — Abril de 2026 — Insoft4 Informática LTDA