Importação de Contatos via Planilha

🎯 Objetivo

Permitir que o usuário importe uma planilha com contatos provenientes de fontes externas à plataforma, de maneira simples e clara, diretamente pela área de Gestão de Contatos > Gestão de Listas.

Como importar uma planilha?

1️⃣ Navegue até Gestão de Contatos no menu lateral esquerdo da plataforma e clique em Gestão de Listas.

2️⃣ Clique em “Clique aqui” para baixar o modelo de planilha recomendado:

⚠️ Importante:
Siga rigorosamente o modelo para evitar erros na importação.
Se não quiser subir algum campo, mantenha a coluna no arquivo e apenas deixe as células em branco.
Não exclua colunas do modelo original.

📄 Especificações da planilha

3️⃣ Com o arquivo preenchido corretamente, arraste-o para o campo “Clique e arraste sua lista de contatos” ou clique para selecionar o arquivo.

📌 Tamanho máximo suportado: 7 MB

Assim que um arquivo válido for inserido, o botão “Importar” ficará habilitado.

✅ Mensagens de retorno

• Importação com sucesso:
  Exibe confirmação visual de sucesso no carregamento da planilha.

• Erro na importação:
  Exibe mensagem de erro com destaque.

🔍 Em caso de erro, verifique:

• Se o cabeçalho segue o padrão do modelo.
• Se os campos estão respeitando os critérios (letras/números).
• Ausência de caracteres inválidos como pontos, traços ou crases.

📥 Indicadores de Status de Upload de CSV

Ao importar uma lista de contatos via arquivo CSV, o sistema exibe indicadores visuais que mostram o andamento e o resultado do processamento. Esses status ajudam o lojista a entender exatamente em que etapa o upload está e se há alguma ação necessária.

Status exibidos

🔄 Processando

O arquivo foi enviado e está sendo analisado e processado pelo sistema.
O que significa: o cliente deve aguardar a conclusão; ainda não é possível visualizar os contatos importados.

✅ Processado

A importação foi concluída com sucesso.
O que significa: todos os contatos válidos do arquivo foram adicionados à lista, sem erros detectados.

⚠️ Importado parcialmente

O arquivo foi processado, mas alguns registros apresentaram erros e não foram importados.
O que significa: parte dos contatos foi adicionada, parte não.
Ação recomendada: o cliente pode revisar o arquivo original para corrigir formatação, campos inválidos ou registros duplicados e tentar novamente.

❌ Erro na importação

O sistema não conseguiu concluir o processamento do arquivo ou não foi possível importar nenhum dos contatos.
O que significa: houve uma falha total na importação.
Ação recomendada: verificar se o arquivo está no formato CSV, se os campos seguem o padrão esperado e tentar novamente.

📌 Observação importante

Os status ficam visíveis diretamente na listagem de Listas de Contatos, permitindo que o lojista acompanhe tudo em tempo real, sem precisar acessar outra tela ou abrir tickets de suporte.

ℹ️ Observações

• Não considerar e-mails de marketplace.
• A contagem exibida na aba de lista de contatos considera apenas pessoas com e-mail válido.