Guia de boas práticas para solicitar suporte técnico

Modificado em Ter, 25 Nov, 2025 na (o) 11:05 AM

Esse artigo tem o intuito de instruir sobre as informações que normalmente serão solicitadas pelo time de suporte técnico para seguir com seu atendimento.


ÍNDICE

Plataforma Web

A plataforma web se refere ao painel de administração, relatórios e aplicação disponível por meio de um acesso via navegador de internet/web. O login pode ser realizado por meio de nosso portal.


Configuração de Checklists

Para problemas com checklists, informe o e-mail da pessoa afetada e especifique se a solicitação é para corrigir um checklist existente ou criar um novo.


Se for um problema em um checklist existente, informe o nome do checklist e detalhe o problema. Caso envolva itens, áreas ou subáreas, inclua os nomes afetados, descreva o que está acontecendo, e, se possível, envie mensagens de erro e capturas de tela.


Se for para criar um novo checklist, descreva a solicitação com detalhes e envie prints ou mensagens de erro, se houver.


Checklists Aplicados

Em casos relacionados à aplicação de checklists, é necessário informar o e-mail da pessoa com o problema e descrever a ação desejada.


Se for para resolver um problema em um checklist existente, informe o ID do checklist e detalhe o problema, incluindo mensagens de erro e capturas de tela, se possível.


Se o problema for a impossibilidade de aplicar um checklist, informe a unidade onde a aplicação está sendo feita, o nome do checklist e descreva em detalhes o ocorrido, anexando prints ou vídeos, se disponíveis.

Por fim, inclua qualquer outra informação que possa ser relevante para a análise.


Usuários e Acessos

Para casos relacionados a usuários e acessos, é fundamental informar o e-mail do usuário afetado. Em seguida, deve-se indicar se a necessidade é resolver um problema com um usuário existente ou criar um novo usuário.


Em ambas as situações, é necessário descrever o problema de forma completa, informar se há mensagens de erro e, se possível, enviar capturas de tela que ajudem a ilustrar a situação. 


Por fim, pedimos que sejam informadas quaisquer outras informações adicionais que possam ser úteis.


E-mails

No caso de problemas envolvendo e-mails, solicitamos que seja informado o e-mail da pessoa impactada e que seja feita uma descrição detalhada do problema.


É importante também informar se há a falta de recebimento de algum e-mail específico. Se o e-mail estiver relacionado a checklists aplicados, solicitamos que informe também o ID do checklist correspondente.


Caso haja mensagens de erro, estas devem ser informadas e, se possível, acompanhadas de capturas de tela. Qualquer outra informação relevante também deve ser comunicada.


API, Integrações com BI

Em solicitações relacionadas à API, o primeiro passo é informar o e-mail do usuário com o problema e descrever a ação desejada.


Se a solicitação for para obter acesso à API, é importante ressaltar que apenas usuários administradores do sistema podem gerar uma chave de acesso. O usuário deverá entrar em contato com alguém que possua essa permissão.


Se o problema for a impossibilidade de conectar à API, será necessário informar qual endpoint e parâmetros estão sendo utilizados, além de descrever o problema em detalhes, informar eventuais mensagens de erro e anexar capturas de tela.


Para o acesso à documentação da API, devem ser utilizados os seguintes links:


Caso ocorram erros no acesso, orientamos tentar novamente em uma guia anônima.


Informações adicionais devem ser informadas.


Power BI

Para problemas envolvendo o Power BI, o e-mail da pessoa impactada deve ser informado inicialmente.


Em seguida, deve-se detalhar a ação necessária: problemas com dados incorretos, dados desatualizados, erro ao visualizar as informações, etc.

Caso o problema esteja relacionado a um dashboard que não foi desenvolvido pela Checklist Fácil, o atendimento deverá ser direcionado internamente para a pessoa responsável pela sua criação. O time de Suporte Técnico da Checklist Fácil oferece suporte apenas aos dashboards desenvolvidos pela nossa equipe de dados.

Em todos os casos, o usuário deve descrever detalhadamente o problema, informar se houve mensagem de erro e, se possível, enviar capturas de tela que facilitem a análise.

Caso existam outras informações, elas também devem ser repassadas.

Relatórios

Em situações relacionadas aos relatórios da plataforma, o usuário deve informar o e-mail da pessoa com o problema e especificar em qual relatório o erro ocorreu.


Também é necessário informar se há mensagens de erro e, se possível, anexar uma captura de tela do erro. Outras informações relevantes podem ser incluídas para melhor entendimento do problema.


Outros

Para problemas não classificados nas categorias anteriores, solicitamos o e-mail da pessoa afetada, uma descrição detalhada do problema, o envio de eventuais mensagens de erro e, se possível, a anexação de capturas de tela.


Além disso, pedimos que informe quaisquer outras informações que considere importantes para o suporte.

Plataforma Mobile


Plataforma mobile se refere aos apps/aplicativos disponibilizados nas lojas de aplicações (Play Store, App Store) nos principais sistemas operacionais móveis (iOS, iPadOS, Android) ou via APK (pacote de
aplicação, somente para Android) em determinadas circunstâncias.


Atualização de Dados

Para tratativas relacionadas à atualização de dados no aplicativo, solicitamos que o usuário descreva o problema enfrentado. É importante informar qual usuário estava logado no momento da ocorrência. Caso alguma mensagem de erro tenha sido exibida, pedimos que envie uma captura de tela ou um vídeo demonstrando o erro. 


Verifique também se o aplicativo está na sua versão mais recente; se não estiver, atualize por meio de sua loja de apps do dispositivo (App Store para iOS/iPadOS, Play Store para Android) e teste novamente. 


Por fim, é essencial serem enviados os logs do aplicativo, acessando a opção "Mais" > "Configurações" > "Enviar log", para aliar nosso time durante a investigação.


Login

Nos casos relacionados a problemas de login, é necessário descrever o problema enfrentado. Caso haja mensagem de erro, envie uma imagem ou vídeo. Também é preciso informar o e-mail do usuário afetado


Além disso, verifique se o aplicativo está atualizado para a última versão. Se não estiver, realize a atualização por meio de sua loja de apps do dispositivo e repita o teste. Por fim, envie os logs do aplicativo acessando "Mais" > "Configurações" > "Enviar log".


Checklist

Para questões relacionadas a checklists, pedimos que descreva a dúvida ou problema enfrentado. Informe o usuário logado no aplicativo, bem como o nome e código do checklist aplicado


Caso ocorra alguma mensagem de erro, envie uma captura de tela ou vídeo. Certifique-se de que a versão do aplicativo é a mais recente, e se não for, atualize por meio de sua loja de apps do dispositivo e realize um novo teste. 


Por fim, envie os logs do aplicativo acessando "Mais" > "Configurações" > "Enviar log".


Workflow

Quando o problema estiver relacionado ao workflow, é importante descrever o erro encontrado. Informe também o código da avaliação aplicada. Garanta que o aplicativo está atualizado para a última versão; caso não esteja, atualize por meio de sua loja de apps do dispositivo e repita o processo. 


Por fim, envie os logs do aplicativo por meio da opção "Mais" > "Configurações" > "Enviar log".


Sincronização

Para problemas de sincronização, solicitamos que o usuário detalhe o problema enfrentado. Informe o código da avaliação e confirme se o aplicativo está atualizado. Se não estiver, atualize por meio de sua loja de apps do dispositivo e tente novamente. Caso exista alguma mensagem de erro, envie uma imagem ou vídeo. O código do checklist aplicado/avaliação (Sequência numérica começando com #) também deve ser informado, pois esse dado pode ajudar a rastrear os resultados que foram sincronizados. Além disso, é importante enviar um print do teste de conexão do dispositivo. Para isso, acesse um navegador, busque por "teste de velocidade" e execute a primeira opção exibida. 


Por fim, envie os logs do aplicativo acessando "Mais" > "Configurações" > "Enviar log".


Agendamentos

Se o problema estiver relacionado a agendamentos, é necessário informar o código da avaliação ou do agendamento. Confirme se o aplicativo está em sua versão mais recente; se não estiver, atualize-o por meio de sua loja de apps do dispositivo e realize um novo teste. Caso haja mensagens de erro, envie um print ou vídeo. Por fim, envie os logs do aplicativo por meio do caminho "Mais" > "Configurações" > "Enviar log".




❓Tem dúvidas? Entre em contato com nosso time de suporte.