Tem uma base de clientes em planilha que você quer trazer pro ShopIA? Esse artigo mostra o passo a passo, os campos que importam, e os cuidados pra não comprometer sua entrega de email.
Quando vale importar CSV
A maioria das lojas não precisa importar nada. Quando você conecta sua loja (WooCommerce, Shopify, etc), o ShopIA puxa todos os clientes automaticamente.
Importar CSV faz sentido quando:
- Você está migrando de outra plataforma (ex: vinha de um CRM antigo)
- Você tem leads que capturou fora do ShopIA (planilha de evento, lista de contato física, etc)
- Sua base atual tem um histórico que a plataforma não passou (lojas que reinstalaram WooCommerce do zero, por exemplo)
O que você vai precisar
- Arquivo CSV com no mínimo email ou telefone em cada linha
- Cabeçalho na primeira linha (ex:
email,telefone,nome,...) - Codificação UTF-8 (Excel salva como "CSV UTF-8 (delimitado por vírgulas)")
Atenção: importe apenas contatos que autorizaram receber comunicação. Importar lista comprada ou raspada da internet vai derrubar sua reputação de email em poucos dias. Mais detalhes em Por que meu email caiu em spam.
Os campos aceitos
| Campo | Obrigatório | Descrição |
|---|---|---|
email | Pelo menos um dos dois | Email do cliente |
telefone | Pelo menos um dos dois | Com DDD, formato livre ((11) 91234-5678 funciona) |
nome | Recomendado | Nome ou primeiro nome |
sobrenome | Não | Sobrenome separado |
data_nascimento | Não | YYYY-MM-DD (ex: 1985-03-15) |
cidade | Não | Cidade |
estado | Não | UF (ex: SP) |
tags | Não | Separadas por ; (ex: vip;reativacao) |
Cabeçalhos podem ser em português ou inglês — o sistema reconhece os dois.
Como importar (3 minutos)
Passo 1: preparar o arquivo
Limpe a planilha antes de importar:
- Remova linhas duplicadas
- Remova linhas com email obviamente inválido (
teste@teste,xxx@xxx) - Garanta que telefone tem DDD (sem DDD não conseguimos identificar a região)
- Salve como CSV UTF-8
Dica: se sua planilha tem mais de 50.000 linhas, divida em arquivos menores (ex: 5 arquivos de 10k). Importações muito grandes ficam mais difíceis de monitorar.
Passo 2: subir o arquivo
- Vá em Clientes no menu lateral
- Clique em Importar CSV (botão no topo da página)
- Arraste seu arquivo ou clique pra selecionar
- O sistema mostra uma pré-visualização das primeiras 10 linhas
Passo 3: mapear colunas
O sistema tenta adivinhar quais colunas são quais. Confira:
- A coluna "Email" foi reconhecida?
- "Telefone" está mapeado?
- "Nome" também?
Se algum mapeamento estiver errado, ajuste manualmente nos seletores.
Passo 4: opções de importação
Antes de confirmar, você decide:
- O que fazer com duplicados: se um email já existe na base, atualizar ou ignorar?
- Tipo padrão: os clientes do CSV são Compradores ou Leads? (se você não tem como saber, marque como Lead)
- Aceitam newsletter: marque apenas se você tem certeza que cada um aceitou. Em caso de dúvida, não marque.
Passo 5: confirmar e aguardar
Clique em Importar.
O sistema processa em segundo plano:
- Até 1.000 linhas: 1-2 minutos
- 1.000 a 10.000: 5-15 minutos
- Acima de 10.000: 20-60 minutos
Você acompanha o progresso na tela. Quando terminar, vê um relatório:
- Total de linhas processadas
- Importados (novos)
- Atualizados (já existiam)
- Ignorados (duplicados ou inválidos)
- Erros (com motivo de cada um)
Pode baixar o relatório em CSV pra revisar.
Cuidados depois de importar
Não mande newsletter pra base toda no mesmo dia
Se você importou 10.000 leads que nunca receberam nada da sua loja, mandar pra todo mundo de uma vez vai:
- Disparar filtro antifraude do Gmail/Outlook
- Gerar muitos bounces (emails inválidos antigos)
- Gerar muitas reclamações (gente que nem lembra de você)
Faça o seguinte:
- Mande primeiro pros mais recentes (últimos 6 meses)
- Espere 2-3 dias, veja o resultado
- Se taxa de bounce ficou abaixo de 5% e taxa de reclamação abaixo de 0,3%, expanda
- Vá subindo aos poucos ao longo de 3-4 semanas
Limpe a base com a primeira newsletter
Quando você manda a primeira newsletter pra base importada, o ShopIA automaticamente move pra lista de bloqueio:
- Emails que não existem mais (bounce permanente)
- Pessoas que clicaram em "marcar como spam"
- Pessoas que pediram opt-out
A partir da segunda newsletter, sua base já está mais limpa.
Marque opt-out manualmente quando souber
Se você sabe que algum cliente não quer mais receber, vá em Clientes, abra o cliente, e marque Opt-out de newsletter. Esse cliente nunca mais recebe email de marketing.
Problemas comuns
"Codificação inválida"
Você salvou como CSV padrão Excel. Salve de novo como CSV UTF-8 (delimitado por vírgulas). Em planilhas Google, Arquivo → Fazer download → CSV já vem em UTF-8.
"Nenhuma linha foi importada"
Provável que o cabeçalho não foi reconhecido. Confira se a primeira linha tem os nomes das colunas (ex: email,nome,telefone) sem espaço extra.
"Telefone inválido"
Telefones sem DDD ou em formato muito estranho são ignorados. O sistema aceita formatos comuns: (11) 91234-5678, 11912345678, +55 11 91234-5678. Mas não aceita 91234-5678 sozinho.
Importação travou em 50%
Atualize a página. Se o status não mudou, vá em Clientes → Importações pra ver o histórico. Se ficou travado, abra ticket pelo suporte com o ID da importação.