> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alana.shopping/llms.txt
> Use this file to discover all available pages before exploring further.

# Solucionando Problemas de Sincronização

> Corrija problemas comuns de sincronização de produtos e entenda mensagens de erro

# 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:**

1. **Aguarde alguns minutos** — Sincronizações iniciais podem levar tempo dependendo do tamanho do catálogo. Verifique novamente em 5-10 minutos.

2. **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

3. **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

4. **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

5. **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:**

1. Vá para **Configurações** > **Integrações**
2. Encontre sua plataforma (você verá um ícone de aviso amarelo)
3. Clique no botão **Reautorizar**
4. Você será redirecionado para sua plataforma
5. Aprove a solicitação de acesso (igual à conexão inicial)
6. Retorne ao Alana—você está reconectado!

**A sincronização automática será retomada imediatamente** após a reautorização.

### Erros de Sincronização no Log de Erros

**Problema:** Você vê mensagens de erro nos detalhes da integração.

**Como visualizar detalhes do erro:**

1. Vá para **Configurações** > **Integrações**
2. Clique no card da sua plataforma
3. Role até **Atividade Recente** ou **Erros de Sincronização**
4. Clique em um erro para ver todos os detalhes

**Mensagens de erro comuns e correções:**

| 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:**

1. **Produto está arquivado/não publicado** — Verifique o status na sua loja
2. **Campos obrigatórios faltando** — Produto pode não ter nome ou preço
3. **Configurações personalizadas bloqueando** — Algumas plataformas têm configurações de visibilidade no nível do produto
4. **Erro temporário de sincronização** — Tente sincronização manual novamente

**Passos para depurar:**

1. Anote o ID ou nome do produto que está faltando
2. Verifique o produto no admin da sua loja (está publicado? tem campos obrigatórios?)
3. Tente editar o produto e salvá-lo novamente (dispara uma ressincronização)
4. Se ainda estiver faltando, [entre em contato com o suporte](/pt/help/faq/contact-support) 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:**

1. **Sincronização manual em andamento** — Apenas uma sincronização pode rodar por vez. Aguarde conclusão.
2. **Loja fora do ar** — Sua plataforma pode estar com inatividade. Verifique a página de status da sua loja.
3. **Cota de API atingida** — Seu plano da loja pode ter limites de requisições de API. Verifique as configurações da sua loja.
4. **Latência de rede** — Raro, mas problemas de rede podem atrasar sincronizações agendadas.

**O que fazer:**

* 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:

1. Vá para **Configurações** > **Integrações**
2. Clique na sua plataforma
3. Role até **Histórico de Sincronização**
4. Visualize detalhes:
   * Data e hora de cada sincronização
   * Produtos adicionados, atualizados, deletados
   * Quaisquer erros encontrados
   * Duração da sincronização

**Dica:** Use o histórico de sincronização para entender padrões e solucionar problemas.

## 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

Clique no indicador de status para ver o que precisa de atenção.

## Quando Entrar em Contato com o Suporte

[Entre em contato com nossa equipe de suporte](/pt/help/faq/contact-support) 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

**Inclua na sua mensagem de suporte:**

* 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

Nossa equipe normalmente responde em até 24 horas.

## Próximos Passos

* **[Aprenda sobre configurações de sincronização](/pt/help/integrations/sync-settings)** — Otimize sua configuração de sincronização
* **[Reconecte sua plataforma](/pt/help/integrations/connecting-platforms)** — Comece do zero com uma nova conexão
* **[Verifique seus créditos de IA](/pt/help/ai/ai-credits-and-usage)** — Pronto para gerar conteúdo para produtos sincronizados?