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

# Entendendo Mensagens de Erro

> Mensagens de erro comuns, o que elas significam e como corrigi-las

# Entendendo Mensagens de Erro

Às vezes o Alana exibe mensagens de erro para informá-lo de que algo não está funcionando corretamente. Este guia explica o que erros comuns significam e como corrigi-los.

## Erros de Autenticação e Login

### "Sessão Expirada"

**O que significa:** Sua sessão de login expirou. Isso acontece se você ficou inativo por um tempo (geralmente 24+ horas) ou se você fez login em outro dispositivo.

**Como corrigir:**

1. Clique em **Fazer Login Novamente** (ou atualize a página)
2. Digite seu email e senha
3. Você estará de volta ao seu workspace

Este é um recurso de segurança que previne acesso não autorizado à sua conta.

### "Credenciais Inválidas"

**O que significa:** Seu email ou senha está incorreto.

**Como corrigir:**

1. Verifique novamente se você está usando o endereço de email correto
2. Verifique sua senha (cuidado com erros de digitação e CAPS LOCK)
3. Se você não consegue lembrar sua senha, clique em **Esqueceu a Senha?**
4. Redefina sua senha e faça login novamente

### "Muitas Tentativas de Login Falhadas"

**O que significa:** Você tentou fazer login com credenciais incorretas várias vezes. Sua conta está temporariamente bloqueada por segurança.

**Como corrigir:**

1. Aguarde 30 minutos
2. Tente fazer login novamente
3. Se ainda não conseguir acessar, use **Esqueceu a Senha?** para redefinir

Este bloqueio previne hackers de adivinhar sua senha.

## Erros de Permissões e Acesso

### "Permissões Insuficientes"

**O que significa:** Você não tem permissão para realizar essa ação. O admin do seu workspace restringiu seu nível de acesso.

**Cenários comuns:**

* Você está tentando deletar uma configuração de workspace (apenas admins podem fazer isso)
* Você está acessando um recurso restrito a membros premium
* Você foi removido de uma equipe ou projeto específico

**Como corrigir:**

1. Peça ao admin do seu workspace para conceder permissão
2. Ou peça a ele para realizar a ação para você
3. Ele pode ajustar sua função em Configurações > Membros da Equipe

### "Acesso Negado"

**O que significa:** Similar a permissões insuficientes—você está tentando acessar algo ao qual sua conta não tem acesso.

**Razões possíveis:**

* Você foi removido deste workspace
* Seu nível de assinatura não inclui este recurso
* O item foi deletado ou arquivado

**Como corrigir:**

1. Verifique se você está no workspace correto (menu suspenso no canto superior esquerdo)
2. Pergunte ao seu admin se você foi acidentalmente removido
3. Faça upgrade do seu plano se o recurso requer um nível superior

### "Você Não Tem Acesso a Este Workspace"

**O que significa:** Este workspace existe, mas você não é um membro.

**Como corrigir:**

1. Peça ao admin do workspace para convidá-lo
2. Ou mude para um workspace diferente onde você tem acesso (menu suspenso no canto superior esquerdo)
3. Se você acha que isso é um erro, [entre em contato com o suporte](/pt/help/faq/contact-support)

## Erros de Sincronização e Integração

### "Conexão Perdida"

**O que significa:** Alana não consegue alcançar sua plataforma de e-commerce para sincronizar produtos.

**Causas possíveis:**

* A API da sua loja está temporariamente fora do ar
* Sua conexão de internet está instável
* A autorização da plataforma expirou

**Como corrigir:**

1. Aguarde alguns minutos (sua loja pode estar temporariamente indisponível)
2. Tente uma sincronização manual (Configurações > Integrações > Sincronizar Agora)
3. Verifique sua conexão de internet
4. Reautorize sua plataforma se o erro persistir

[Saiba mais sobre solução de problemas de sincronização](/pt/help/integrations/troubleshooting-sync).

### "Limite de Taxa da API Excedido"

**O que significa:** Você fez muitas requisições para a API da sua loja em um curto período. Sua loja tem limites de taxa por razões de performance.

**Como corrigir:**

1. Aguarde 15 minutos e tente novamente
2. A sincronização será automaticamente refeita
3. Reduza sua frequência de sincronização se isso acontecer regularmente

Isso normalmente só acontece com catálogos muito grandes ou sincronizações manuais frequentes.

### "Credenciais da API Inválidas"

**O que significa:** As credenciais de conexão se tornaram inválidas ou desatualizadas.

**Como corrigir:**

1. Vá para Configurações > Integrações
2. Encontre a conexão da plataforma
3. Clique em **Reautorizar**
4. Siga o fluxo de autorização da plataforma
5. A sincronização será retomada

Esta é uma medida de segurança que ocasionalmente requer reautorização.

### "Sincronização Falhou - Verifique o Log de Erros"

**O que significa:** O processo de sincronização encontrou um erro. O log de erros tem mais detalhes.

**Como corrigir:**

1. Vá para Configurações > Integrações
2. Clique na sua plataforma
3. Role até o log de erros ou atividade recente
4. Clique no erro para ver todos os detalhes
5. A maioria dos erros são auto-resolúveis ou têm próximos passos acionáveis

[Veja o guia detalhado de solução de problemas de sincronização](/pt/help/integrations/troubleshooting-sync) para mensagens de erro específicas.

## Erros de Produto e Importação

### "Validação de Importação Falhou"

**O que significa:** Seu arquivo de importação tem problemas de dados. Ele não corresponde ao formato esperado.

**Problemas possíveis:**

* Cabeçalhos de colunas não correspondem aos campos esperados
* Colunas obrigatórias estão faltando (ex: nome do produto)
* Tipos de dados estão errados (ex: texto onde um número é esperado)
* Formato de arquivo não é suportado (deve ser CSV, XLSX ou JSON)

**Como corrigir:**

1. Baixe o relatório de erros (geralmente lista linhas específicas com problemas)
2. Abra seu arquivo em um aplicativo de planilha (Excel, Google Sheets)
3. Corrija os problemas listados no relatório de erros
4. Faça upload do arquivo novamente

[Veja o guia detalhado de importação](/pt/help/catalogs/importing-products) para requisitos exatos de formato.

### "Tamanho do Arquivo Excede o Limite"

**O que significa:** Seu arquivo de importação é muito grande (máximo 50MB).

**Como corrigir:**

1. Divida seu arquivo em lotes menores
2. Importe cada lote separadamente
3. Ou comprima imagens e dados antes de fazer upload

### "Produto Duplicado Detectado"

**O que significa:** Um produto no seu arquivo de importação já existe no seu catálogo.

**Como corrigir:**

1. Verifique se você não importou acidentalmente o mesmo arquivo duas vezes
2. Remova linhas duplicadas do seu arquivo
3. Use identificadores únicos (SKU, ID do produto) para prevenir duplicatas
4. Faça upload novamente

## Erros de IA e Geração

### "Créditos de IA Esgotados"

**O que significa:** Você não tem créditos de IA suficientes para realizar esta geração. Você está sem créditos para este mês.

**Como corrigir:**

1. Vá para Configurações > Cobrança para verificar seu saldo de créditos de IA
2. Aguarde sua renovação mensal (créditos renovam na sua data de cobrança)
3. Ou faça upgrade para um plano com mais créditos
4. Ou compre créditos adicionais se disponível

[Saiba mais sobre créditos de IA](/pt/help/ai/ai-credits-and-usage).

### "Geração Falhou - Por Favor Tente Novamente"

**O que significa:** O serviço de IA encontrou um problema temporário.

**Como corrigir:**

1. Aguarde um minuto
2. Tente gerar novamente
3. Se continuar falhando, tente um produto diferente
4. [Entre em contato com o suporte](/pt/help/faq/contact-support) se for um problema persistente

### "Dados Insuficientes do Produto para Geração"

**O que significa:** O produto está faltando informações essenciais necessárias para a IA gerar conteúdo.

**Informações necessárias:**

* Nome do produto
* Descrição ou categoria do produto
* Pelo menos uma imagem do produto (para geração baseada em imagem)

**Como corrigir:**

1. Vá para os detalhes do produto
2. Adicione informações faltantes (nome, descrição, categoria, imagem)
3. Salve o produto
4. Tente gerar novamente

## Erros de Sistema e Servidor

### "500 - Erro Interno do Servidor"

**O que significa:** Algo deu errado nos servidores do Alana. Isso é raro.

**Como corrigir:**

1. Atualize a página
2. Aguarde alguns minutos
3. Tente novamente
4. Se o erro persistir, [entre em contato com o suporte](/pt/help/faq/contact-support)

### "Timeout de Conexão"

**O que significa:** A página levou muito tempo para carregar. Ou sua conexão está lenta ou o servidor está ocupado.

**Como corrigir:**

1. Verifique a velocidade da sua conexão de internet
2. Atualize a página
3. Tente novamente em alguns minutos
4. Use uma conexão com fio em vez de WiFi se possível

### "O Serviço Está Temporariamente Indisponível"

**O que significa:** Alana está temporariamente fora do ar para manutenção ou experimentando alto tráfego.

**Como corrigir:**

1. Aguarde 5-15 minutos e tente novamente
2. Verifique nossa página de status (se disponível)
3. Você ainda pode exportar seus dados enquanto o serviço está fora
4. [Entre em contato com o suporte](/pt/help/faq/contact-support) para previsão

## Mensagens de Erro em um Relance

| Erro                           | Causa                   | Correção Rápida                            |
| ------------------------------ | ----------------------- | ------------------------------------------ |
| Sessão Expirada                | Inativo por muito tempo | Faça login novamente                       |
| Credenciais Inválidas          | Email ou senha errados  | Use Esqueceu a Senha                       |
| Permissões Insuficientes       | Você não tem acesso     | Peça ao admin do workspace                 |
| Conexão Perdida                | Loja indisponível       | Aguarde e tente novamente                  |
| Limite de Taxa Excedido        | Muitas requisições      | Aguarde 15 minutos                         |
| Validação de Importação Falhou | Formato de arquivo ruim | Corrija erros e faça upload novamente      |
| Créditos de IA Esgotados       | Sem créditos mensais    | Faça upgrade do plano ou aguarde renovação |
| 500 - Erro Interno             | Problema no servidor    | Atualize e tente novamente                 |

## Ainda Vendo Erros?

Se você encontrar um erro não listado aqui ou não conseguir resolvê-lo:

1. Tente atualizar a página (Cmd+R ou Ctrl+R)
2. Limpe o cache do seu navegador
3. Tente em modo anônimo
4. Tente um navegador diferente
5. [Entre em contato com o suporte](/pt/help/faq/contact-support) com:
   * A mensagem de erro exata
   * O que você estava tentando fazer
   * Capturas de tela se possível
   * Nome do seu workspace

Nossa equipe normalmente responde em até 24 horas.
