Como importar contatos via CSV

Pra cadastrar muitos contatos de uma vez (planilha com 200 leads, exportação de outro CRM, etc), use a Importação CSV/Excel do Syncro. Você sobe o arquivo, o sistema detecta automaticamente quais colunas correspondem a quais campos (Nome, Telefone, Email, etc), você revisa o mapeamento, e o Syncro importa tudo respeitando duplicatas e o limite do plano.

Pré-requisitos

• Permissão de admin ou manager.

• Arquivo nos formatos: XLSX, XLS ou CSV.

• Tamanho máximo: 5 MB.

• Plano com slots de leads disponíveis pra acomodar a importação.

Preparar o arquivo

A planilha precisa ter uma linha de cabeçalho com nomes das colunas. Não precisa seguir nomes exatos — o Syncro reconhece variações:

💡 Dica: pra evitar dores, use os nomes da coluna em português simples. "Nome", "Telefone", "Email" funcionam direto.

Exemplo de planilha pronta

Passo a passo da importação

Step 1 — Upload e preview

1. Acesse Contatos.

2. Clique em Importar no canto superior direito.

3. Abre o modal Importar Contatos.

4. Clique em Selecione seu arquivo e escolha sua planilha.

5. O Syncro processa e mostra:

• Colunas detectadas do arquivo

• Preview das primeiras 5 linhas

• Mapeamento sugerido automaticamente

Step 2 — Revisar mapeamento

Pra cada coluna do arquivo, há um dropdown "Como mapear pra Syncro?" com opções:

• Nome (geralmente já vem detectado)

• Telefone

• E-mail

• Empresa

• Valor

• Origem

• Observações

• Tags (separadas por vírgula)

• Custom: {nome do campo} — se você tem campos personalizados configurados, eles aparecem aqui

• — Ignorar coluna — — pra colunas que você não quer importar

Confira se cada coluna está mapeada corretamente. Você pode ajustar se a detecção automática errou.

⚠️ Atenção: pelo menos uma coluna deve estar mapeada como Nome — é o único campo obrigatório no Syncro. Sem nome, a importação falha.

Step 3 — Avisos de duplicata

O Syncro escaneia o arquivo e detecta possíveis duplicatas com leads existentes (por telefone ou email). Se encontrar:

• Aparece um aviso: "X possíveis duplicatas detectadas. Revise em Contatos > Duplicatas após importar."

• A importação continua normalmente — duplicatas são marcadas pra revisão posterior na fila de duplicatas.

Step 4 — Limite do plano

O Syncro verifica seu slots disponíveis:

• Se sua planilha tem 300 leads e você só tem 150 slots disponíveis no plano: o Syncro avisa antes de importar e pergunta se você quer importar só 150 ou cancelar.

• Se você optar por importar parcialmente, os primeiros 150 entram e o resto fica de fora.

Step 5 — Importar

1. Confirme o mapeamento.

2. Clique em Importar.

3. O Syncro processa o arquivo (pode levar alguns segundos pra arquivos grandes).

4. Aparece o resultado:

• {N} contatos importados com sucesso

• {N} ignorados por limite de plano (se aplicável)

• {N} possíveis duplicatas detectadas (link pra fila)

Atribuir lead a um funil/etapa específico

Por padrão, leads importados vão Growth funil padrão do tenant na primeira etapa. Pra customizar:

• Adicione coluna Funil ou Etapa na planilha (ainda não suportado em todos os campos — verifique mapeamento disponível).

• Após importação, edite leads em massa via filtro + drawer (manual hoje).

• Considere automação com gatilho lead_created que move o lead pra etapa certa baseado em algum critério (ex: tag).

Atribuir responsável

Se você quer que cada lead importado tenha um responsável pré-definido:

• Coluna Responsável com o nome do usuário do tenant — se reconhecer, vincula.

• Senão, leads ficam sem responsável e podem ser distribuídos via departamento (round-robin / least-busy).

Tags em massa

Pra importar leads com tags:

• Coluna Tags com valores separados por vírgula: ex vip, b2b, paulista.

• O Syncro cria tags novas se não existirem ou reaproveita existentes.

Erros comuns

"Arquivo vazio ou sem linhas de dados"

Sua planilha tem só cabeçalho e nenhuma linha de dado. Adicione contatos e tente de novo.

"Apenas XLSX, XLS e CSV são suportados"

Verifique se o arquivo tem extensão correta. Não use ODT, TXT ou outros formatos.

"Limite atingido. Faça upgrade para importar."

Você não tem slots disponíveis. Faça upgrade do plano ou exclua leads antigos pra liberar.

"Nenhuma coluna mapeada como Nome"

Marque pelo menos uma coluna como Nome no step de mapeamento.

Telefones não importados

Se telefones aparecem em formato estranho (ex: 5,5119999E+10), no Excel formate como Texto antes de exportar. Senão, pode haver perda de dígitos.

Encoding errado (acentos virou ?)

Salve o CSV em UTF-8. No Excel: Salvar como → CSV UTF-8 (delimitado por vírgulas).

Performance

Pra arquivos grandes:

• Até 1.000 linhas: importação em segundos.

• 1.000-10.000 linhas: até 1-2 minutos.

• >10.000 linhas: divida em arquivos menores (recomendado), ou aguarde alguns minutos.

A importação roda síncrono no servidor — você precisa esperar. Não fecha o modal antes de terminar.

Como o Syncro detecta duplicatas durante a importação

Pra cada linha do arquivo:

1. Telefone normalizado — só dígitos. Procura match exato em leads existentes.

2. Email — case-insensitive. Match exato.

3. Nome fuzzy — comparação de similaridade > 85%.

Score 70+ = possível duplicata. Lead é importado (não pula), mas é registrado na fila de duplicatas pra revisão posterior.

Após importar — revisar duplicatas

Após a importação, vá em Contatos → Duplicatas pra revisar a fila e mesclar os pares detectados. Veja Detectar e mesclar duplicatas.

Importação cumulativa

Você pode importar várias vezes. Cada importação adiciona ao banco — não substitui os leads existentes. Se importar a mesma planilha duas vezes:

• Primeira: cria todos os leads.

• Segunda: detecta duplicatas e marca pra revisão (mas ainda assim importa).

Pra evitar duplicatas no segundo upload, filtre seu CSV removendo os já existentes antes de importar de novo.

Próximos passos

• Após importar, veja a fila de duplicatas pra mesclar os pares.

• Pra organizar em listas, veja Listas de contatos.

• Pra exportar pra outro sistema, veja Exportar contatos.

Artigos relacionados

• Criar contato manualmente

• Detectar e mesclar duplicatas

• Tags de contatos

• Campos personalizados

• Listas de contatos