Skip to main content

Erro ao importar planilha de contatos

Se a importação de contatos falhou ou trouxe avisos linha a linha, este artigo explica as causas mais comuns e como corrigir a planilha.

Objetivo

Concluir a importação de contatos sem erros, usando a planilha modelo do sistema.

Pré-requisitos

  • Permissão para gerenciar contatos

Tempo estimado

5 minutos.

Caminho de acesso

CRM → Contatos → importação

Passo a passo

  1. Abra a importação de contatos e clique em Baixar planilha modelo. Sempre parta do modelo: ele já tem as colunas certas. Veja Importar importar-contatos em lote via planilha.

🖼️ PRINT — Janela Importar contatos com o botão Baixar planilha modelo em destaque e a opçãoárea Registrospara jáenviar existentesa planilha.

  1. Preencha o modelo sem apagar nem renomear as colunas do cabeçalho. Salve como .xlsx, .xls ou .csv (são os únicos formatos aceitos).
  2. EmArraste o arquivo até a área de upload (ou clique nela para escolher) e clique em RegistrosContinuar.
Na tela de mapeamento, em Contatos já existentes, escolha o comportamento para duplicados:
  • Atualizar existentes — sobrescreve os dados de quem já está cadastrado.
  • Pular duplicadosexistentes — mantém o cadastro atual e ignora a linha repetida. Para contatos, oO duplicado é detectado pelo telefone.; linhas sem telefone sempre criam um contato novo.
Clique em Escolher arquivo, selecione a planilha preenchida e clique em Importar. Aoe, ao final, leia o resumo: quantos foram criados, atualizados e ignorados, além dos avisos por linha (ex.: Linha 5: ...).

Resultado esperado

Aparece o resumo no formato "X criados, Y atualizados, Z ignorados". As linhas com problema vêm listadas com o número da linha e a descrição, para você corrigir e reenviar só elas.

Erros comuns

  • Sintoma: "Formato não suportado" ou "Erro ao importar a planilha" logo de cara. Solução: o arquivo não é .xlsxxlsx, .xls nem .csv, ou o cabeçalho foi alterado. Baixe o modelo de novo e recomece a partir dele.
  • Sintoma: contatos vieram duplicados. Solução: verifique os telefones — números escritos de formas diferentes não são reconhecidos como o mesmo contato. Padronize com DDD.
  • Sintoma: avisos "Linha X" apontando telefone. Solução: corrija as linhas indicadas (telefone vazio ou inválido) e reenvie a planilha.
  • Sintoma: o resumo mostra "N contatos criados sem telefone". Solução: a coluna Telefone não foi mapeada (ou ficou vazia) nessas linhas; esses contatos não entram em campanhas nem em conversas de WhatsApp. Corrija o mapeamento e reimporte.
Sintoma: esperava atualizar, mas os contatos foram ignorados. Solução: você escolheu Pular duplicadosexistentes; troque para Atualizar existentes e importe de novo.

Artigos relacionados