Solucionando Problemas de Sincronização
Se seus produtos não estão sincronizando corretamente, não se preocupe. A maioria dos problemas de sincronização é fácil de resolver. Este guia orienta você pelos problemas mais comuns e suas soluções.Problemas Comuns de Sincronização e Soluções
Produtos Não Aparecem Após Conexão
Problema: Você conectou sua plataforma, mas os produtos não estão aparecendo no Alana. Soluções:- Aguarde alguns minutos — Sincronizações iniciais podem levar tempo dependendo do tamanho do catálogo. Verifique novamente em 5-10 minutos.
-
Verifique filtros de produtos — Alguns produtos podem estar ocultos por filtros:
- Vá para Configurações > Integrações > Sua Plataforma
- Procure por configurações de filtro (ex: “Sincronizar apenas produtos publicados”)
- Certifique-se de que os filtros não estão excluindo seus produtos
-
Verifique o status do produto na sua loja — Apenas produtos publicados e ativos são sincronizados:
- Faça login no admin da sua loja
- Verifique se os produtos estão marcados como publicados ou ativos
- Produtos arquivados ou em rascunho não aparecerão no Alana
-
Verifique imagens grandes — Se os produtos têm imagens muito grandes (>50MB), eles podem ser ignorados:
- Otimize as imagens na sua loja (comprima para tamanhos razoáveis)
- Dispare uma sincronização manual
-
Dispare uma sincronização manual — Às vezes a sincronização inicial precisa de um empurrãozinho:
- Vá para Configurações > Integrações
- Clique na sua plataforma e selecione Sincronizar Agora
- Aguarde a conclusão do processo
Conexão Expirada (Autorização Necessária)
Problema: Você vê mensagem “Conexão expirada” ou “Reautorização necessária”. Por que acontece: Seu token de autorização da plataforma expirou (geralmente após 6-12 meses, dependendo da plataforma). Solução:- Vá para Configurações > Integrações
- Encontre sua plataforma (você verá um ícone de aviso amarelo)
- Clique no botão Reautorizar
- Você será redirecionado para sua plataforma
- Aprove a solicitação de acesso (igual à conexão inicial)
- Retorne ao Alana—você está reconectado!
Erros de Sincronização no Log de Erros
Problema: Você vê mensagens de erro nos detalhes da integração. Como visualizar detalhes do erro:- Vá para Configurações > Integrações
- Clique no card da sua plataforma
- Role até Atividade Recente ou Erros de Sincronização
- Clique em um erro para ver todos os detalhes
| Erro | Causa | Correção |
|---|---|---|
API rate limit exceeded | Muitas requisições para sua loja | Aguarde 15 minutos, depois dispare sincronização manual |
Invalid product data | Um produto tem dados corrompidos ou inválidos | Edite o produto na sua loja e salve |
Image not accessible | URL da imagem do produto está quebrada | Atualize a imagem na sua loja |
Permission denied | Alana perdeu acesso à sua loja | Reautorize (veja acima) |
Connection timeout | Problema de rede ou loja fora do ar | Verifique status da loja, depois tente sincronizar novamente |
Alguns Produtos Sincronizam, Outros Não
Problema: A maioria dos produtos sincroniza, mas alguns estão faltando. Causas prováveis:- Produto está arquivado/não publicado — Verifique o status na sua loja
- Campos obrigatórios faltando — Produto pode não ter nome ou preço
- Configurações personalizadas bloqueando — Algumas plataformas têm configurações de visibilidade no nível do produto
- Erro temporário de sincronização — Tente sincronização manual novamente
- Anote o ID ou nome do produto que está faltando
- Verifique o produto no admin da sua loja (está publicado? tem campos obrigatórios?)
- Tente editar o produto e salvá-lo novamente (dispara uma ressincronização)
- Se ainda estiver faltando, entre em contato com o suporte com o ID do produto
Frequência de Sincronização Não Está Funcionando
Problema: Você configurou sincronização automática para “a cada hora” mas as mudanças não aparecem no horário. Razões possíveis:- Sincronização manual em andamento — Apenas uma sincronização pode rodar por vez. Aguarde conclusão.
- Loja fora do ar — Sua plataforma pode estar com inatividade. Verifique a página de status da sua loja.
- Cota de API atingida — Seu plano da loja pode ter limites de requisições de API. Verifique as configurações da sua loja.
- Latência de rede — Raro, mas problemas de rede podem atrasar sincronizações agendadas.
- Dispare uma sincronização manual para garantir que a conexão está funcionando
- Se a sincronização manual falhar, tente reautorizar
- Verifique o uso e cota da API da sua loja
Visualizando Histórico de Sincronização
Para ver um registro detalhado de todas as sincronizações:- Vá para Configurações > Integrações
- Clique na sua plataforma
- Role até Histórico de Sincronização
- Visualize detalhes:
- Data e hora de cada sincronização
- Produtos adicionados, atualizados, deletados
- Quaisquer erros encontrados
- Duração da sincronização
Verificando Status da Integração
Uma forma rápida de saber se tudo está funcionando:- Indicador verde — Todas as sincronizações estão saudáveis, sem problemas
- Indicador amarelo — Aviso: intervenção manual pode ser necessária
- Indicador vermelho — Erro: ação imediata necessária
Quando Entrar em Contato com o Suporte
Entre em contato com nossa equipe de suporte se:- Você tentou todos os passos de solução de problemas e a sincronização ainda não está funcionando
- Você vê mensagens de erro repetidas que não entende
- Sua conexão continua expirando inesperadamente
- Você precisa de ajuda com uma integração de plataforma personalizada
- Sua loja está em um plano que requer configuração especial
- Nome do seu workspace
- A plataforma que você está tentando sincronizar
- A mensagem de erro (se aplicável)
- Capturas de tela do problema
- Quando o problema começou
Próximos Passos
- Aprenda sobre configurações de sincronização — Otimize sua configuração de sincronização
- Reconecte sua plataforma — Comece do zero com uma nova conexão
- Verifique seus créditos de IA — Pronto para gerar conteúdo para produtos sincronizados?