1. [Ajuda](https://nuvia.ai/docs) 2. [Listas](https://nuvia.ai/docs/colecoes/19377988-listas) # Como importar contatos via CSV Importe contatos ou empresas em massa para a Nuvia via CSV. Disponível em todos os planos Quem pode fazer qualquer usuário com permissão de edição na lista Atualizado em 3 de novembro de 2026 [Listas](https://nuvia.ai/docs/colecoes/19377988-listas) 1. [Como gerenciar listas e contatos](https://nuvia.ai/docs/artigos/14499469-como-gerenciar-listas-e-contatos) 2. [Como enriquecer contatos em uma lista](https://nuvia.ai/docs/artigos/14688472-como-enriquecer-contatos-em-uma-lista) 3. [Como importar contatos via CSV](https://nuvia.ai/docs/artigos/14576336-como-importar-contatos-via-csv) 4. [Como usar as tabelas de Listas, Pessoas, Empresas e Conversas](https://nuvia.ai/docs/artigos/17314020-como-usar-as-tabelas-de-listas-pessoas-empresas-e-conversas) Nesta página 1. O que você precisa antes de começar 2. Passo 1 – Carregar arquivo 3. Passo 2 – Mapeamento de colunas 4. Passo 3 – Normalização de dados 5. Passo 4 – Reconciliação 6. Passo 5 – Confirmar 7. Limites e regras 8. Erros comuns e soluções **Nesta página8 seções** 1. O que você precisa antes de começar 2. Passo 1 – Carregar arquivo 3. Passo 2 – Mapeamento de colunas 4. Passo 3 – Normalização de dados 5. Passo 4 – Reconciliação 6. Passo 5 – Confirmar 7. Limites e regras 8. Erros comuns e soluções A importação via CSV permite carregar contatos ou empresas de uma planilha externa diretamente para uma lista na Nuvia. Para criação de listas pelo módulo de buscas, consulte a [documentação específica](https://nuvia.ai/docs/artigos/14501104-como-criar-listas-a-partir-de-resultados-de-busca). ## O que você precisa antes de começar - 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** (Pessoa ou Empresa) deve existir no CSV (é o único campo obrigatório) ## Passo 1 – Carregar arquivo 1. No menu lateral, clique em **Listas** 2. Abra a lista onde quer importar os contatos 3. Clique em **Importar / Exportar** > **Importar CSV** 4. Arraste o arquivo CSV para a área tracejada ou clique para selecionar 5. Aguarde o sistema processar e detectar as colunas do arquivo Após o upload, você verá o número de linhas encontradas e as colunas detectadas no cabeçalho. Use **Trocar arquivo** para substituir o arquivo se necessário. 6. 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 do contato** – selecionar o campo correspondente, ou **Ignorar** para descartar a coluna ### Mapeamento automático É mapeado 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 CampoObrigató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 CampoObrigató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 ### Formato correto do campo LinkedIn O campo **LinkedIn** aceita dois tipos de valor: - **slugs** (ex: joao-silva, geralmente em minúsculas) e - **hashes** (ex: ACoAABcDeFg123456, com letras maiúsculas e minúsculas misturadas). Hashes aparecem em URLs do Sales Navigator e em perfis que não têm slug público configurado. É extraído automaticamente o identificador do contato, mas o valor precisa estar formatado corretamente para não ser descartado. FormatoExemploResultado armazenado URL completa com /in/ [https://www.linkedin.com/in/joao-silva](https://www.linkedin.com/in/joao-silva) joao-silva URL completa com hash (ID interno) [https://www.linkedin.com/in/ACoAABcDeFg123456](https://www.linkedin.com/in/ACoAABcDeFg123456) ACoAABcDeFg123456 Apenas o identificador (slug) joao-silva joao-silva Apenas o hash sem URL ACoAABcDeFg123456 ACoAABcDeFg123456 **Valores inválidos que serão descartados:** - URLs sem o padrão /in/ (ex: [https://linkedin.com/pub/fulano/123/456](https://linkedin.com/pub/fulano/123/456)) - Qualquer URL que não seja do LinkedIn (ex: [https://www.google.com/](https://www.google.com/)...) Dica A forma mais segura de preencher o campo é colar a URL completa diretamente da barra de endereço do LinkedIn. ### 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: - **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 Cada campo de um registro existente exibe uma tag indicando o que o sistema vai fazer no momento da importação: - **Atualizar** (azul) – vai sobrescrever o valor atual com o do CSV - **Manter** (cinza) – vai preservar o valor que já está na plataforma - **Editado** (laranja, com ícone de lápis), campo que você ajustou manualmente no passo de Normalização. Como o valor foi revisado por você, ele já vai ser usado na importação e não pode ser alterado nessa tela Clique em qualquer tag azul ou cinza para alternar entre **Atualizar** e **Manter**. Tags laranjas ficam fixas, para mudá-las, volte ao passo 3 e ajuste o valor. ### Aplicar a regra para um campo inteiro No cabeçalho da tabela há uma marcação ao lado de cada campo mapeado. Use para mudar todos os registros daquele campo de uma só vez: - **Campo marcado (✓)** Define todos os registros como **Atualizar** (vai usar o valor do CSV) - **Campo desmarcado** ( ) Define todos os registros como **Manter** (vai conservar o valor atual) Dica Defina a regra geral de cada campo pelo cabeçalho e depois ajuste apenas as exceções clicando linha a linha. Registros **novos** e campos com tag **Editado** (laranja) não são afetados pela mudança em massa do cabeçalho. Importante O campo **Telefone** nunca é atualizado em contatos existentes, independente da resolução escolhida. Para empresas, o **CNPJ** também não é atualizado. ### Remover linhas da importação Para remover uma linha específica, clique no ícone de **lixeira** ao lado do registro. Clique novamente para restaurar. ### Como funciona o matching (desduplicação) É identificado registros existentes pelos seguintes campos: - **Para Contatos:** Telefone > E-mail > LinkedIn (nesta ordem de prioridade) **Para Empresas:** o campo de busca que você escolheu na seção **Vincular Empresa** durante o mapeamento (**Domínio**, **Nome** ou **CNPJ)** O **Nome** do contato nunca é usado para deduplicação. Se nenhum dos três campos de identificação (Telefone, E-mail ou LinkedIn) estiver mapeado, é tratado todas as linhas como novas. 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á: - **Novos:** quantidade de novos registros que serão criados - **Atualizações:** quantidade de atualizações em registros existentes - **Alterações:** registros sem alteração - **Campos mapeados:** resumo das associações definidas no passo 2 Clique em **Importar** para executar. ## Limites e regras RegraValor 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 não é usado) Deduplicação de Empresas Campo único escolhido em **Vincular Empresa** (Domínio, Nome ou CNPJ) Colunas não mapeadas Ignoradas, os dados dessas colunas não são importados ## Erros comuns e soluções ProblemaCausa provávelSoluçã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?** Para contatos, a prioridade de matching é **Telefone > E-mail > LinkedIn**. O primeiro campo que encontrar uma correspondência define o match. O campo **Nome** não é usado para identificar duplicatas. Para empresas, é o campo único de busca que você escolheu na seção **Vincular Empresa** durante o mapeamento (Domínio, Nome ou CNPJ). **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](https://nuvia.ai/docs/artigos/14580091-como-usar-campos-personalizados) para mais detalhes. **Qual é o formato correto para preencher o LinkedIn no CSV?** Você pode usar a URL completa ([https://www.linkedin.com/in/joao-silva](https://www.linkedin.com/in/joao-silva)) ou apenas o identificador (joao-silva). Para perfis com hash (ID interno do LinkedIn, comum no Sales Navigator), use a URL completa ou copie o hash exatamente como aparece, ex: ACoAABcDeFg123456. O sistema extrai o identificador automaticamente. Valores sem o padrão /in/ são descartados. **O identificador LinkedIn importado precisa estar em minúsculas?** Não. O sistema preserva a capitalização original do valor importado. Isso é especialmente importante para identificadores com hash (usados em perfis do Sales Navigator), que contêm letras maiúsculas e minúsculas misturadas. Mesmo assim, a deduplicação entre registros funciona ignorando essas diferenças (ACoAABcDeFg e acoaabcdefg) são reconhecidos como o mesmo contato. [AnteriorComo enriquecer contatos em uma lista](https://nuvia.ai/docs/artigos/14688472-como-enriquecer-contatos-em-uma-lista) [PróximoComo usar as tabelas de Listas, Pessoas, Empresas e Conversas](https://nuvia.ai/docs/artigos/17314020-como-usar-as-tabelas-de-listas-pessoas-empresas-e-conversas) Este artigo ajudou? ## Artigos relacionados - [Como criar a sua primeira lista de contatos na Nuvia](https://nuvia.ai/docs/artigos/14489491-como-criar-a-sua-primeira-lista-de-contatos-na-nuvia) - [Como gerenciar listas e contatos](https://nuvia.ai/docs/artigos/14499469-como-gerenciar-listas-e-contatos) - [Como configurar integração com HubSpot](https://nuvia.ai/docs/artigos/14501908-como-configurar-integracao-com-hubspot) - [Como usar campos personalizados](https://nuvia.ai/docs/artigos/14580091-como-usar-campos-personalizados) - [Como sincronizar contatos e deals entre Nuvia e HubSpot](https://nuvia.ai/docs/artigos/14590403-como-sincronizar-contatos-e-deals-entre-nuvia-e-hubspot) [Listas](https://nuvia.ai/docs/colecoes/19377988-listas) 1. [Como gerenciar listas e contatos](https://nuvia.ai/docs/artigos/14499469-como-gerenciar-listas-e-contatos) 2. [Como enriquecer contatos em uma lista](https://nuvia.ai/docs/artigos/14688472-como-enriquecer-contatos-em-uma-lista) 3. [Como importar contatos via CSV](https://nuvia.ai/docs/artigos/14576336-como-importar-contatos-via-csv) 4. [Como usar as tabelas de Listas, Pessoas, Empresas e Conversas](https://nuvia.ai/docs/artigos/17314020-como-usar-as-tabelas-de-listas-pessoas-empresas-e-conversas) ## Ainda precisa de ajuda? Clientes falam com o suporte pelo chat dentro da plataforma. Ainda não é cliente? Fale com o nosso time. [Falar com o suporte na plataforma](https://app.nuvia.ai) [Ainda não sou cliente](https://nuvia.ai/contact) --- Source: https://nuvia.ai/docs/artigos/14576336-como-importar-contatos-via-csv