Quando o painel ShopIA não carrega ou demora muito, há causas tanto do lado do servidor quanto do navegador local. Esta página lista o diagnóstico em ordem de probabilidade.
Sintomas comuns
- Página fica em branco ao acessar
- Tela de carregamento indefinida ("Loading...")
- Sidebar carrega mas o conteúdo não aparece
- Botões não respondem
- Notificações no sininho param de atualizar
- Navegador trava com mensagem "página não responde"
Causa 1: cache do navegador
O Service Worker e cache do navegador podem reter versão antiga após atualização do ShopIA.
Como resolver
- Abra o painel.
- Pressione
Ctrl + Shift + R(Windows/Linux) ouCmd + Shift + R(Mac) para forçar reload sem cache. - Se persiste, limpe cache:
- Chrome: três pontos > Mais ferramentas > Limpar dados de navegação > Período: última hora > Imagens e arquivos em cache
- Tente em aba anônima primeiro — confirma se é cache.
Causa 2: extensão do navegador interferindo
Extensões de bloqueio de anúncios, antivírus ou privacidade podem bloquear partes do painel.
Como verificar
- Abra o painel em aba anônima (extensões geralmente desabilitadas).
- Se funciona em anônima, é extensão.
- Identifique a culpada desabilitando uma a uma.
Extensões mais comuns que causam problema:
- AdBlock e similares (bloqueia tracking interno)
- Antivírus com proteção web (Norton, Avast, etc.)
- Privacy Badger
- Ghostery
Como resolver
Adicione *.shopia.com.br à whitelist da extensão.
Causa 3: conexão lenta ou instável
Painel carrega muitos componentes em paralelo. Conexões lentas ou intermitentes resultam em carregamento parcial.
Como verificar
- Teste velocidade em fast.com ou speedtest.net.
- Conexão deve ser pelo menos 5 Mbps de download.
Como resolver
- Trocar de Wi-Fi para 4G ou vice-versa
- Reiniciar roteador
- Em hotspot móvel, garantir sinal forte
Causa 4: navegador desatualizado
Navegadores antigos podem ter incompatibilidade com componentes modernos do painel.
Versões mínimas suportadas
| Navegador | Mínimo |
|---|---|
| Chrome | 110+ |
| Firefox | 110+ |
| Safari | 16+ |
| Edge | 110+ |
Internet Explorer não é suportado.
Como resolver
Atualize o navegador para versão atual.
Causa 5: storage local cheio ou corrompido
LocalStorage e IndexedDB podem corromper em casos raros, especialmente após atualizações grandes.
Como resolver
- Abra DevTools (F12).
- Aba Application (Chrome) ou Storage (Firefox).
- Localize shopia.com.br ou app.shopia.com.br.
- Clique em Clear storage > Clear site data.
- Recarregue a página.
Atenção: isso desconecta sua sessão. Você precisa fazer login novamente.
Causa 6: incidente do servidor
Em casos raros, há problema na infraestrutura do ShopIA.
Como verificar
- Acesse status.shopia.com.br (página de status público).
- Confira se há incidente em andamento.
- Acompanhe atualizações.
<!-- TODO: confirmar com Gabriel se status page já está implementada -->
Como resolver
Aguarde resolução do incidente. ShopIA notifica em status page e por email para super admins.
Causa 7: conta suspensa por billing
Se sua conta tem problema de cobrança, o painel pode mostrar tela específica de suspensão em vez do conteúdo.
Como verificar
A tela de suspensão é diferente — vermelha, com mensagem clara sobre billing.
Como resolver
- Acesse Configurações > Plano > Histórico de faturas.
- Resolva fatura pendente.
- Conta é reativada em até 5 minutos.
Causa 8: muitos dados em uma página
Páginas como Clientes ou Pedidos com filtros que retornam dezenas de milhares de registros podem demorar.
Como resolver
- Adicione filtros para reduzir resultado
- Use paginação (avance entre páginas em vez de tentar mostrar tudo)
- Em Clientes > Mais filtros, restrinja por período ou status
Causa 9: bloqueio de DNS por provedor
Alguns provedores de internet brasileiros bloqueiam ocasionalmente domínios novos. Sintoma: painel não carrega, mas outros sites carregam normalmente.
Como verificar
Tente acessar via 4G (rede diferente). Se funciona, é DNS do seu provedor.
Como resolver
- Mude DNS para Google DNS (8.8.8.8) ou Cloudflare (1.1.1.1)
- Em casos persistentes, contate provedor
Causa 10: bloqueio empresarial (rede corporativa)
Algumas empresas bloqueiam domínios não-aprovados em rede interna.
Como verificar
Acesse via 4G fora do escritório. Se funciona, é bloqueio corporativo.
Como resolver
Solicite ao TI da empresa para liberar *.shopia.com.br.
Quando entrar em contato com o suporte
Se você passou por todas as causas acima e o painel ainda trava:
- Abra ticket informando:
- Sistema operacional (Windows 11, macOS Sonoma, etc.) - Navegador e versão - URL específica em que trava - Hora aproximada de quando começou - Print da tela - Console do DevTools (F12 > aba Console) — copiar mensagens de erro
Suporte tem ferramentas para diagnosticar problemas específicos da sua conta.
Casos resolvidos por tempo
Em raros casos, problemas se resolvem sozinhos:
- Cache do CDN expira (até 5 minutos)
- DNS propaga novamente (até 30 minutos)
- Navegador limpa estado interno
Se o problema é intermitente, vale tentar novamente em 15-30 minutos antes de escalar.