Clientes - Importar

O que é

A página de importação serve para subir muitos clientes de uma vez por planilha, geralmente quando você está migrando de outro sistema (por exemplo, Excapy) ou recebeu uma lista pronta de uma campanha. Em vez de cadastrar um por um, você envia um arquivo Excel ou CSV e o sistema cria os registros em lote.

O fluxo é em três passos guiados na própria tela: Upload do arquivo, Preview com mapeamento de colunas e checagem de duplicados, e Resultado com o resumo do que foi importado, atualizado, ignorado ou apresentou erro.

Como usar

1. Vá em Cadastros > Clientes no menu lateral e abra Importar Clientes pelo dropdown de ações da listagem.
2. No card Baixe o modelo de planilha, clique em Excel (.xlsx) ou CSV (.csv) para obter um arquivo já com os cabeçalhos esperados e exemplos preenchidos.
3. Preencha a planilha. O único campo obrigatório é Nome. Demais campos reconhecidos automaticamente: Email, CPF, RG, Passaporte, Dt. Nascimento, Telefone, Celular, Instagram, CEP, Endereço, Número, Complemento, Bairro, Cidade e Estado.
4. Arraste o arquivo para a área Arraste seu arquivo aqui ou clique para selecionar ou clique para escolher do computador. Limite: 10 MB, extensões aceitas .xlsx, .xls ou .csv.
5. Clique em Continuar. A tela avança para o passo Preview, que mostra quatro contadores no topo: Total de linhas, Validos, Duplicados e Com erros.
6. Revise o Mapeamento de colunas e preview. Cada coluna da planilha tem um seletor logo acima indicando para qual campo do cliente ela aponta. Ajuste pelo dropdown se algo veio errado ou marque -- Ignorar -- para pular colunas que não interessam. As 10 primeiras linhas aparecem coloridas conforme a legenda (verde = novo, âmbar = duplicado, vermelho = erro).
7. No card Opções de importação, marque o que se aplica:
   • Adicionar ao CRM como lead - cada cliente importado entra no funil de vendas do CRM (vem marcado por padrão).
   • Ignorar clientes duplicados (mesmo email ou CPF) - pula registros que já existem na base (vem marcado por padrão).
   • Atualizar dados de clientes existentes (preencher campos vazios) - usa a planilha para completar campos que estavam em branco no cadastro já existente.
8. Clique em Importar Clientes. Ao final, a tela Resultado exibe quantos foram Importados, Atualizados, Ignorados e Com erros, com a lista das linhas que falharam.
9. Use Ver Clientes para voltar à listagem ou Nova Importação para subir outra planilha.

Casos especiais

Planilha vinda do Excapy

Se os cabeçalhos do arquivo combinarem com a assinatura do Excapy (Status, Data de Cadastro, Nome, Email, Telefone Residencial, Telefone Celular), a tela mostra a faixa azul Formato identificado: Excapy acima do mapeamento e já deixa as colunas vinculadas aos campos corretos. Só revise e confirme.

Campos personalizados do cliente

Se você tem campos customizáveis ativos para a entidade Cliente, eles aparecem no dropdown de mapeamento sob a seção ── Campos Personalizados ──. Use esse grupo para destinar uma coluna da planilha para um campo customizado (prefixo cf_ interno).

Apenas atualizar clientes existentes

Para enriquecer a base sem criar novos registros, deixe Atualizar dados de clientes existentes marcado e Ignorar clientes duplicados desmarcado. Linhas com email ou CPF coincidentes terão os campos vazios preenchidos pelos valores da planilha; clientes novos seguem sendo criados.

Importar sem alimentar o CRM

Desmarque Adicionar ao CRM como lead antes de clicar em Importar Clientes. Os registros entram só no cadastro de clientes, sem aparecer no funil do CRM.

Erros comuns e como resolver

• "Arquivo vazio ou inválido" - A planilha não tem dados ou está corrompida. Reabra no Excel, confirme que há cabeçalhos na primeira linha e pelo menos uma linha preenchida, e salve novamente.
• "Erro ao processar arquivo: ..." - Formato não reconhecido por trás do envio. Garanta extensão .xlsx, .xls ou .csv e tamanho até 10 MB.
• "Formato de arquivo invalido. Use Excel (.xlsx, .xls) ou CSV." - Validação no navegador antes do envio. Verifique a extensão real do arquivo (não basta renomear).
• "Arquivo muito grande. O tamanho máximo e 10MB." - Quebre a planilha em vários arquivos menores ou exporte como CSV (mais leve que XLSX).
• "Nome é obrigatório" na coluna de erros do preview - Alguma linha está sem nome. Preencha na planilha e refaça o upload, ou marque para ignorar duplicados/erros e siga em frente (essas linhas não serão importadas).
• "Email inválido" - O valor não passa pela validação de email. Corrija na planilha (formato [email protected]).
• "CPF inválido" - O CPF não tem 11 dígitos após remover pontuação. Confira a planilha - o modelo aceita CPF com ou sem máscara.
• Linhas marcadas em âmbar (Cliente existente) - Não é erro: o sistema detectou email ou CPF já cadastrado. Decida entre Ignorar duplicados ou Atualizar dados de clientes existentes antes de importar.

Onde encontrar

• URL: /admin/clientes-import
• Caminho no menu: Cadastros > Clientes (botão de importar na listagem)
• Permissão necessária: criar os clientes
• Módulo necessário: nenhum

Veja também

• Clientes - Listagem
• Cadastrar Cliente