Importando contatos arquivo CSV

Aprenda a importar contatos para o sistema usando um arquivo CSV, incluindo carregamento, mapeamento e confirmação dos dados, e a importação opcional de oportunidades.

Atualizado em 25 de agosto de 2026

Importante

A importação é suportada apenas através do formato de arquivo CSV (.csv). Outros tipos de arquivo, como Excel ou Planilhas Google, não são aceitos.

Pré-requisitos para importar contatos

Antes de iniciar o processo de importação, certifique-se de que atende aos seguintes requisitos:

Permissões do usuário: somente usuários com acesso de administrador podem importar contatos.
Formato do arquivo: o arquivo deve estar no formato CSV (.csv).
Limite de tamanho do arquivo: o arquivo CSV deve ter menos de 30 MB. Se for maior, divida-o em arquivos menores.
Requisito de planilha única: seu arquivo CSV deve conter apenas uma planilha/aba.
Requisito para CSV: a primeira linha NÃO deve estar em branco! Inclua uma linha de cabeçalho na qual pelo menos um cabeçalho de coluna corresponda a um campo do sistema.

Erros comuns a evitar

Cabeçalhos incompatíveis: certifique-se de que os cabeçalhos do arquivo CSV correspondam aos campos do sistema.
Campos obrigatórios em branco: cada linha deve ter pelo menos um campo obrigatório (Nome, E-mail ou Telefone).
Uso de caracteres especiais em números de telefone: remova espaços, hífens ou letras.
Registros duplicados no CSV: limpe a lista antes de importar.

Importando contatos usando o formato de arquivo CSV

Importar contatos para o sistema é a maneira mais rápida de trazer seus leads, clientes ou listas de consumidores para a plataforma. Seja para migrar de outro CRM, integrar novos clientes ou configurar sua primeira campanha de marketing, a ferramenta de importação permite que você carregue e organize contatos rapidamente usando um simples arquivo CSV. Você também pode optar por importar oportunidades simultaneamente, tornando a configuração do seu pipeline ainda mais eficiente.

Passo 1: Navegue até a aba Contatos

Na caixa de ferramentas de navegação, clique no botão Importar Contatos.

Etapa 2: Selecione o que importar

Escolha se deseja importar apenas Contatos ou Contatos e Oportunidades.

Etapa 3: Carregue seu arquivo CSV

Após selecionar a opção para importar contatos, clique em Avançar, carregue seu arquivo CSV e selecione o tipo de importação correto, dependendo se você está adicionando novos contatos ou atualizando os existentes.

Nota

Ao atualizar contatos, o sistema verifica se já existem registros com base na seguinte ordem: ID do contato → E-mail → Telefone. Essa ordem de correspondência garante atualizações precisas e evita duplicatas. Você pode alterar suas configurações de desduplicação ou saber mais sobre Permitir contatos duplicados (Preferências de desduplicação de contatos).

Etapa 4: Mapeamento de colunas para campos

Certifique-se de que cada coluna do seu arquivo esteja corretamente mapeada para o campo correspondente no sistema. Algumas observações importantes:

Marcar a caixa de seleção 'Não atualizar valores vazios' impedirá a atualização de qualquer campo se o arquivo importado contiver valores vazios e o campo possuir algum valor para a oportunidade.
Se você optar por não importar um determinado campo, pode deixá-lo sem mapeamento e marcar a caixa na parte inferior para prosseguir: 'Certifique-se de que todos os campos obrigatórios estejam mapeados. Para prosseguir, mapeie todos os campos ou selecione Não importar dados para colunas não mapeadas'.
Se os Contatos e as Oportunidades estiverem na mesma linha no arquivo CSV, eles serão mapeados automaticamente um para o outro.

Nota

Se o seu arquivo CSV incluir dados para campos que ainda não existem no sistema, você precisará criar esses campos como Campos Personalizados antes de concluir a importação. O sistema permite mapear colunas CSV para campos padrão e personalizados, mas somente se esses campos já estiverem criados em sua conta.

Etapa 5: Verificar, confirmar e finalizar a seleção

Finalize a configuração revisando suas preferências, verificando o mapeamento de campos e confirmando o consentimento antes de iniciar a importação. Esta etapa final garante que os contatos sejam etiquetados, classificados e adicionados aos fluxos de trabalho corretamente, com seus dados totalmente verificados.

Preferências: ações opcionais antes da importação

Crie uma SmartList para novos contatos.
Adicione contatos importados a um fluxo de trabalho.
Marque os contatos importados para facilitar a segmentação.
Revise o mapeamento de campos. Certifique-se de que todos os campos obrigatórios estejam mapeados corretamente. Confirme se os campos personalizados estão atribuídos conforme o esperado. Opcional: colunas não mapeadas serão ignoradas automaticamente.

Importar Contatos e Oportunidades

Se o seu arquivo CSV incluir informações de contato e de negócio (oportunidade), você pode importar ambos simultaneamente usando o mesmo fluxo. Isso é especialmente útil se você estiver integrando novos leads diretamente ao seu funil de vendas e quiser associá-los a um estágio ou valor de negócio durante a importação. O processo permanece exatamente o mesmo que importar contatos; a única diferença é selecionar 'Contatos' e 'Oportunidades' durante a configuração inicial da importação.

Após clicar no botão Importar na página Contatos, você será solicitado a selecionar os objetos a serem importados. Basta marcar ambos e prosseguir com os mesmos passos descritos acima.

Dica

Seu arquivo CSV deve incluir colunas relacionadas à oportunidade (por exemplo, Pipeline, Etapa, Status, Nome da Oportunidade) para que os dados sejam criados corretamente. Você pode deixar os campos sem mapeamento, se não forem necessários.

Monitorar o status da importação

Você pode acompanhar o progresso e o status da importação por meio das páginas de ações em massa de Contatos e Oportunidades.

Tanto a importação de contatos quanto a de oportunidades aparecerão no mesmo local, em Ações em Massa.
Clique no botão 'Mostrar Estatísticas' para visualizar as estatísticas da importação. Você também pode baixar o registro de erros e ver mais detalhes sobre o erro e como corrigi-lo na guia 'Erro'.