Como importar contatos via CSV — Traga sua base de leads para a Nuvia

A importação via CSV permite que você carregue contatos ou empresas de uma planilha externa diretamente para uma lista na Nuvia. O processo usa um wizard de 5 passos que guia desde o upload do arquivo até a confirmação da importação, incluindo mapeamento de colunas, resolução de conflitos com registros existentes e vinculação automática entre contatos e empresas.

Disponível em: todos os planos.

Quem pode fazer: qualquer usuário com permissão de edição na lista.

Módulo: Menu lateral > Listas > abrir lista > Importar / Exportar > Importar CSV

O que você precisa antes de começar

Ter uma lista criada na Nuvia (ou criar uma durante o processo)
Ter um arquivo .csv pronto para importação
O arquivo deve ter no máx. 10MB e até 1.000 linhas
A primeira linha do arquivo deve conter o cabeçalho com os nomes das colunas
O campo Nome deve existir no CSV (é o único campo obrigatório)

Preparar o arquivo CSV

Antes de iniciar a importação, prepare seu arquivo:

Formato: apenas .csv é aceito (não .xlsx, .xls ou .tsv)
Tamanho máximo: 10MB
Linhas máximas: 1.000 por importação (para arquivos maiores, divida em partes)
Cabeçalho: a primeira linha deve conter os nomes das colunas
Codificação: UTF-8 (para evitar problemas com acentos e caracteres especiais)

💡 Dica: Para arquivos com mais de 1.000 linhas, divida em múltiplos CSVs e importe cada um separadamente na mesma lista. O sistema acumula os registros.

Passo 1 — Carregar arquivo

No menu lateral, clique em Listas
Abra a lista onde quer importar os contatos
Clique em Importar / Exportar > Importar CSV
Arraste o arquivo CSV para a área tracejada ou clique para selecionar
Aguarde o sistema processar e detectar as colunas do arquivo

Após o upload, você verá:

O número de linhas encontradas
As colunas detectadas no cabeçalho

Use Trocar arquivo para substituir o arquivo se necessário.

Clique em Próximo para continuar

Passo 2 — Mapeamento de colunas

Neste passo, você associa as colunas do CSV aos campos da plataforma.

A tabela mostra duas colunas:

Coluna do CSV — nome da coluna no arquivo + exemplo do primeiro valor
Campo de destino — dropdown para selecionar o campo correspondente, ou Ignorar para descartar a coluna

Mapeamento automático

O sistema tenta mapear automaticamente colunas com nomes reconhecíveis:

Se a coluna se chama...	Mapeia para
telefone, celular, phone, whatsapp, fone	Telefone
nome, name, contato	Nome
email, mail	E-mail
linkedin, linkedinurl	LinkedIn
ddi, codigopais, countrycode	Código do País

Revise os mapeamentos automáticos e ajuste se necessário.

Campos mapeáveis — Contato

Campo	Obrigatório
Nome	Sim
Telefone	Não
E-mail	Não
LinkedIn	Não
Código do País (DDI)	Não
Cargo	Não
Senioridade	Não
Departamento	Não
País	Não
Região	Não
Cidade	Não
Experiência	Não
Habilidades	Não
Campos customizados	Não
Colunas da lista	Não

Campos mapeáveis — Empresa

Campo	Obrigatório
Nome	Sim
Domínio	Não
CNPJ	Não
Setor/Indústria	Não
Site	Não
LinkedIn	Não
Descrição	Não
Campos customizados	Não

Vincular Empresa (listas de Contato)

Expanda a seção Vincular Empresa para associar automaticamente cada contato à empresa correspondente. Escolha o campo de busca: Domínio, Nome ou CNPJ. A empresa deve já existir na plataforma para o vínculo funcionar.

Vincular Contato (listas de Empresa)

Expanda a seção Vincular Contato para associar contatos existentes às empresas importadas. Escolha o campo de busca (Telefone, E-mail, Nome ou LinkedIn) e o separador se uma célula contiver múltiplos contatos (vírgula, ponto e vírgula ou pipe).

O botão Próximo só habilita quando o campo Nome estiver mapeado.

Passo 3 — Normalização de dados

Neste passo, o sistema exibe os dados já normalizados automaticamente. Revise os valores processados para garantir que estão corretos antes de prosseguir.

Clique em Próximo para continuar.

Passo 4 — Reconciliação

Aqui o sistema identifica quais registros já existem na plataforma — sem salvar nada ainda.

Você verá um resumo com contadores:

Novos — registros que serão criados
Existentes — registros que já existem e serão atualizados
Removidos — linhas que você opcionalmente excluiu da importação

Resolver conflitos em registros existentes

Para cada campo mapeado de registros existentes, você verá duas opções clicáveis:

"CSV" (azul) — usa o valor do CSV, sobrescrevendo o valor atual
"Manter" (cinza) — mantém o valor atual da plataforma

Clique na tag para alternar entre as opções. A decisão se aplica a todos os registros existentes na importação.

Remover linhas da importação

Para remover uma linha específica, clique no ícone de lixeira ao lado do registro. Clique novamente para restaurar.

⚠️ Importante: O campo Telefone nunca é atualizado em contatos existentes, independente da resolução escolhida. Para empresas, o CNPJ também não é atualizado.

Como funciona o matching (deduplicação)

O sistema usa prioridade de campos para identificar registros existentes:

Para Contatos: Telefone > E-mail > LinkedIn > Nome

Para Empresas: CNPJ > Domínio > Nome

Se nenhum campo de match estiver mapeado, o sistema não consegue identificar duplicatas e trata todos os registros como novos.

O botão Próximo só habilita se houver pelo menos 1 linha ativa (não removida).

Passo 5 — Confirmar

Revisão final antes de importar. Você verá:

Verde: quantidade de novos registros que serão criados
Azul: quantidade de atualizações em registros existentes
Neutro: registros sem alteração
Campos mapeados: resumo das associações definidas no passo 2

Clique em Importar para executar.

Durante o processamento, o modal não pode ser fechado. O botão mostrará "Importando..." com indicador de progresso.

Mensagem de sucesso

Após a conclusão, você verá uma mensagem como: "Importação concluída: X inserido(s), Y registro(s) criado(s), Z empresa(s) vinculada(s), W contato(s) vinculado(s)."

Como saber se deu certo

A mensagem de sucesso exibe a contagem de registros criados e atualizados
A lista mostra os novos registros na tabela
O status da lista é Pronta (ou Parcial, se houve erros em algumas linhas)

Limites e regras

Regra	Valor
Formato aceito	Apenas `.csv`
Tamanho máximo do arquivo	10MB
Linhas máximas por importação	1.000
Mínimo de colunas mapeadas	1 (o campo Nome é obrigatório)
Campo Telefone em contatos existentes	Nunca é atualizado via importação
Campo CNPJ em empresas existentes	Nunca é atualizado via importação
Deduplicação de Contatos (prioridade)	Telefone > E-mail > LinkedIn > Nome
Deduplicação de Empresas (prioridade)	CNPJ > Domínio > Nome
Colunas não mapeadas	Ignoradas — os dados dessas colunas não são importados

Erros comuns e soluções

Problema	Causa provável	Solução
Botão "Próximo" desabilitado no mapeamento	Campo Nome não mapeado	Mapeie uma coluna do CSV para o campo Nome
Arquivo não aceito	Formato diferente de `.csv`	Converta o arquivo para CSV (salve como CSV no Excel ou Google Sheets)
"Arquivo excede o tamanho máximo de 10MB"	Arquivo muito grande	Divida o CSV em partes menores de até 1.000 linhas cada
Importação concluída com 0 inseridos	Todos os registros já existiam e não havia alterações	Comportamento normal. Os registros já estavam na base sem divergências
Lista com status "Erro"	Falha no processamento do arquivo	Verifique o formato do CSV (cabeçalho na primeira linha, campos separados por vírgula) e tente novamente
Aviso amarelo no mapeamento de empresa	Seção "Vincular Empresa" ativada sem campo de busca mapeado	Mapeie a coluna do CSV para o campo de busca correspondente (Domínio, Nome ou CNPJ)
Caracteres estranhos nos dados importados	Codificação do CSV não é UTF-8	Salve o CSV como UTF-8 antes de importar

Perguntas frequentes

Posso importar mais de 1.000 contatos de uma vez?

Não em uma única importação. O limite é de 1.000 linhas por operação. Para volumes maiores, divida o arquivo em partes de até 1.000 linhas e importe cada parte na mesma lista. O sistema acumula os registros.

O que acontece se minha planilha tiver colunas que não existem na Nuvia?

Colunas não mapeadas são simplesmente ignoradas — os dados dessas colunas não são importados. Apenas as colunas que você mapear para campos da plataforma serão processadas.

Posso importar um arquivo Excel (.xlsx)?

Não. Apenas o formato .csv é aceito. Abra o arquivo no Excel ou Google Sheets e salve como CSV antes de importar.

O telefone do contato é atualizado se eu importar novamente o mesmo contato?

Não. O campo Telefone de contatos existentes nunca é sobrescrito pela importação, mesmo que você escolha "CSV" na etapa de reconciliação. Para atualizar o telefone de um contato, edite-o diretamente na plataforma.

Como o sistema sabe que um contato já existe?

O sistema usa uma prioridade de campos para matching: Telefone > E-mail > LinkedIn > Nome (para contatos) e CNPJ > Domínio > Nome (para empresas). O primeiro campo mapeado que encontrar uma correspondência define o match.

Posso desfazer uma importação?

Não há desfazer automático. Para remover registros importados por engano, remova-os individualmente da lista ou exclua a lista inteira.

O que significa o status "Parcial" após a importação?

Indica que a importação foi concluída, mas algumas linhas tiveram erro (formato inválido, campo obrigatório ausente). Os registros válidos foram importados normalmente. A lista pode ser usada no estado Parcial.

Posso vincular contatos a empresas durante a importação?

Sim. Na etapa de mapeamento, expanda a seção Vincular Empresa e escolha o campo de busca (Domínio, Nome ou CNPJ). O sistema tentará associar cada contato à empresa correspondente, desde que a empresa já exista na plataforma.

Preciso mapear todos os campos do CSV?

Não. Apenas o campo Nome é obrigatório. Todos os outros campos são opcionais. Colunas que você marcar como Ignorar não serão importadas.

Posso importar campos customizados via CSV?

Sim. Na etapa de mapeamento, os campos customizados configurados na plataforma aparecem como opções de destino. Mapeie a coluna do CSV para o campo customizado desejado. Consulte Como usar campos personalizados para mais detalhes.