Solução de problemas
Lista dos problemas mais comuns e como resolvê-los.
Login e acesso
Esqueci minha senha
- Na tela de login, procure o link “Esqueci minha senha” (se disponível)
- Se não aparecer, entre em contato com o suporte. Por segurança, a redefinição de senha é feita por um administrador
A opção de “trocar senha” dentro do painel (botão Senha no cabeçalho) altera apenas a senha local do navegador, não a senha da sua conta no Appwrite. Se você quer mudar a senha da conta, peça ao administrador.
Não consigo entrar mesmo com a senha certa
Possíveis causas:
- O Caps Lock está ativado
- Você está tentando entrar na conta errada
- O servidor está temporariamente fora do ar
Tente:
- Verifique se o Caps Lock está desligado
- Tente em uma janela anônima do navegador
- Aguarde 5 minutos e tente novamente (pode ser instabilidade temporária)
- Se persistir, peça ao administrador para resetar sua senha
O painel carrega mas fica travado em “Carregando…”
Possíveis causas:
- Sua sessão expirou (24 horas)
- O servidor está com instabilidade
Tente:
- Faça logout (botão Sair) e login novamente
- Limpe o cache do navegador (
Ctrl + Shift + Delete/Cmd + Shift + Delete) - Tente em outro navegador
Edição e salvamento
Mudei alguma coisa no painel mas não aparece na página pública
Possíveis causas:
- Cache do navegador
- Você está olhando a página errada
Tente:
- Atualize a página pública com
Ctrl + Shift + R(ouCmd + Shift + Rno Mac) — isso força o recarregamento sem cache - Abra a página em uma janela anônima
- Aguarde 30 segundos (o cache do navegador pode demorar para atualizar)
Tentei fazer upload de uma imagem e deu erro
Possíveis causas:
- Imagem maior que 5 MB
- Formato não suportado (apenas PNG, JPG e WEBP)
- Conexão de internet instável durante o upload
Tente:
- Comprima a imagem para menos de 5 MB
- Converta para PNG, JPG ou WEBP se estiver em outro formato
- Tente novamente com uma conexão de internet estável
A imagem do link aparece cortada
Possíveis causas:
- A imagem tem proporção muito diferente do card (ex: muito alta e estreita)
- Você não ajustou a posição de foco
Tente:
- Use uma imagem com proporção mais próxima do card (16:9 para largura total, 1:1 para grid)
- Ajuste a posição de foco: abra a edição do link, role até “Posição de Foco da Imagem” e clique no ponto da imagem que quer como centro
- Ou troque a imagem por uma com proporção melhor
Links e botões
Um link da minha página está dando erro 404
Possíveis causas:
- A URL foi digitada errada
- A página de destino foi removida ou mudou de endereço
- O site de destino está fora do ar
Tente:
- Abra a URL em uma nova aba e veja se funciona
- Se der erro, corrija a URL no painel
- Se a URL estiver certa mas o site está fora do ar, considere desativar o link até o site voltar
Os cliques não estão sendo registrados no Analytics
Possíveis causas:
- O JavaScript está desabilitado no navegador do visitante
- O cache do navegador
- A página está sendo pré-carregada mas não visualizada
Como verificar:
- Abra a página pública
- Abra o console do navegador (
F12→ aba “Console”) - Clique em um link
- Veja se aparece algum erro vermelho
Se aparecer erro de JavaScript, o problema é com o navegador do visitante (ou o cache do seu navegador). Tente Ctrl + Shift + R para forçar recarregamento.
Performance
A página pública demora para carregar
Possíveis causas:
- Imagens muito pesadas
- Muitos links
- Internet lenta do visitante
O que fazer:
- Comprima todas as imagens para menos de 200 KB cada
- Use formatos WEBP (mais leves que JPG/PNG)
- Reduza a quantidade de links na página
- Use Cabeçalhos para organizar a lista em vez de adicionar mais cards
O painel está lento
Possíveis causas:
- Muitos links na lista (centenas)
- Conexão lenta com o servidor
O que fazer:
- Verifique se você tem uma quantidade razoável de links (recomendamos até 30)
- Tente em outro horário (pode ser pico de uso)
- Tente em outro navegador
Quando nada resolve
Se você tentou tudo nesta página e o problema persiste:
- Anote exatamente o que está acontecendo — qual tela, qual ação, qual mensagem de erro
- Inclua o navegador e sistema operacional (ex: “Chrome no Windows 11”)
- Envie para o suporte com essas informações
Quanto mais detalhada a descrição, mais rápido o problema é resolvido.