📌 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á funcionandoObjetivo: 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 andamentoObjetivo: 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 vivoObjetivo: 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çasObjetivo: 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 atividadesObjetivo: 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?
🧠 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?Na configuração atual, o sistema se conecta a um leitor QFace por vez, identificado pelo endereço configurado em Configurações → Aba QFace.
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 suportePara 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