Diferente do WooCommerce, a conexão Shopify é gerenciada via OAuth e pode expirar ou ser revogada por motivos específicos. Esta página explica os cenários mais comuns e como restabelecer a conexão.
Sintomas
- Banner vermelho "Shopify desconectado" no painel
- Pedidos novos não aparecem desde determinada hora
- Erro
401 Unauthorizedem logs (visível para suporte) - Mensagem "App desinstalado" vinda da Shopify
Causa 1: app desinstalado pelo lojista
A causa mais comum. Alguém com acesso ao admin Shopify desinstalou o app ShopIA. Pode ser:
- Você mesmo, sem perceber
- Um membro da equipe limpando apps inativos
- A própria Shopify, em rotina de manutenção
Como verificar
- Acesse o admin Shopify (
admin.shopify.com). - Vá em Apps.
- Procure ShopIA.
Se não aparecer, o app foi desinstalado.
Como resolver
- No painel ShopIA, vá em Configurar > Conexões > Shopify.
- Clique em Reinstalar app.
- Você é redirecionado para o admin Shopify.
- Confirme as permissões.
- Após instalação, o app volta a funcionar e a sincronização incremental retoma do ponto onde parou.
Causa 2: rotação de credenciais Shopify
Public Apps na Shopify usam Token Exchange em vez de tokens permanentes. Tokens têm validade de 24 horas e são renovados automaticamente. Em casos raros, a renovação falha:
- API da Shopify temporariamente indisponível
- Conta da loja com restrição de billing na Shopify
- Mudança de plano na Shopify (Basic, Shopify, Plus)
O sistema tenta reconectar automaticamente. Se falhar três vezes consecutivas, exibe banner pedindo reconexão manual.
Como resolver
- Garanta que a conta Shopify está com pagamento em dia.
- Em Configurar > Conexões > Shopify, clique em Reautorizar.
- Faça login no admin Shopify e confirme.
Causa 3: troca de plano na Shopify
Mudar de Shopify Basic para Shopify Plus, ou vice-versa, pode invalidar webhooks existentes em alguns cenários. O ShopIA registra webhooks novamente após reautorização.
Como resolver
- Após mudança de plano, acesse Configurar > Conexões > Shopify.
- Clique em Reautorizar.
- O sistema registra todos os webhooks necessários sob o novo plano.
Causa 4: troca de proprietário da loja Shopify
Se a propriedade da loja Shopify foi transferida para outra conta Google ou outro email, os tokens existentes são invalidados pela própria Shopify por segurança.
Como resolver
A reautorização precisa ser feita pelo novo proprietário ou por um colaborador com permissão de instalar apps.
Causa 5: scopes alterados em nova versão do app
Quando o ShopIA libera nova versão do app público com escopos adicionais (ex.: leitura de inventário), você precisa reaprovar as permissões. Sem isso, a versão antiga continua funcionando, mas funcionalidades novas ficam indisponíveis.
Como resolver
- No painel ShopIA, banner amarelo aparece com mensagem "Atualização disponível".
- Clique em Atualizar app Shopify.
- Reaprove os escopos solicitados.
O que NÃO desconecta a Shopify
- Trocar senha do admin Shopify
- Adicionar ou remover usuário da loja Shopify
- Alterar email de notificação Shopify
- Mudar tema da loja
- Trocar domínio personalizado
Esses eventos não afetam a conexão.
Histórico de pedidos durante desconexão
Pedidos criados durante o período de desconexão não são perdidos. Após reconectar:
- O sistema executa sincronização de catch-up.
- Pedidos dos últimos 7 dias são reimportados (janela padrão de fallback).
- Para janela maior, contate suporte.
Detalhes do mecanismo em Sincronização atrasada: o que verificar.
Sandbox separado
Se você opera em ambiente sandbox Shopify (loja de desenvolvimento), a conexão é independente da loja de produção. Reconectar uma não afeta a outra.
Quando entrar em contato com o suporte
Se a reautorização falha repetidamente:
- Verifique se a conta Shopify está ativa (não em pausa por billing)
- Confirme que o usuário que está reautorizando tem permissão de instalar apps
- Abra ticket informando: domínio Shopify (
*.myshopify.com), data e hora da última desconexão observada