# Como importar leads de uma planilha (CSV ou Excel) na WavUps CRM

> Para importar leads na WavUps CRM, abra **Leads**, clique em **Importar**, escolha um arquivo CSV, XLSX ou XLS, ligue cada campo do CRM a uma coluna da planilha (ou a um valor fixo) e confirme a importação. Linhas com o mesmo CPF/CNPJ ou celular de um lead existente atualizam esse lead em vez de criar outro.

Fonte: Central de ajuda da WavUps CRM — https://crm.wavups.com/docs/leads/importar-leads-de-planilha (atualizado em 8 de outubro de 2026)

## Antes de começar: prepare a planilha

- Formatos aceitos: **CSV**, **XLSX** e **XLS**. Só a **primeira aba** da planilha é lida.
- Deixe uma linha por lead e, de preferência, os nomes das colunas na primeira linha (ex.: Nome, E-mail, Celular, CPF/CNPJ, Cidade).
- Toda linha precisa de **nome**. Linhas sem nome são ignoradas.
- Se os nomes das colunas forem iguais aos campos da WavUps CRM, o mapeamento vem pronto. "Telefone", "Celular", "WhatsApp" e "Mobile" viram **Celular**; "CPF", "CNPJ" e "Documento" viram **CPF / CNPJ**; "CEP", "Endereço" e "Número" também são reconhecidos.

## Passo a passo

### Passo 1: Abra a importação

No menu **Leads**, clique em **Importar**, ao lado de **Novo lead**. Abre a janela **Importar Leads**.

![Tela Leads com o botão Importar, ao lado de Novo lead, destacado.](https://crm.wavups.com/images/docs/leads-lista.png)

### Passo 2: Escolha o arquivo

Clique em **Selecionar arquivo** (ou arraste a planilha para a área tracejada) e escolha o arquivo CSV ou XLSX. Se a primeira linha **não** tiver os nomes das colunas, desmarque **A primeira linha do arquivo contém os cabeçalhos das colunas**: as colunas passam a se chamar "Coluna A", "Coluna B" e assim por diante.

![Janela Importar Leads com a área para arrastar o arquivo e o botão Selecionar arquivo destacado.](https://crm.wavups.com/images/docs/leads-importar-arquivo.png)

### Passo 3: Confira os dados lidos

A WavUps CRM mostra quantas **linhas** e **colunas** encontrou e a lista de campos do CRM para mapear. Se o número de linhas não bate com a sua planilha, clique em **Voltar** e confira o arquivo.

![Janela Importar Leads na etapa de mapeamento, com a quantidade de linhas e colunas lidas e a lista de campos do CRM.](https://crm.wavups.com/images/docs/leads-importar-mapeamento.png)

### Passo 4: Mapeie cada campo

Para cada campo, escolha o **Tipo de Mapeamento** **(1)**: **Mapear coluna** (e depois a **Coluna da Planilha** **(2)**), **Valor fixo** (o mesmo valor para todos os leads) ou **Deixar vazio**. O **Nome** é obrigatório e precisa estar mapeado.

![Campo Nome do mapeamento com o Tipo de Mapeamento Mapear coluna e a Coluna da Planilha escolhida.](https://crm.wavups.com/images/docs/leads-importar-mapeamento.png)

### Passo 5: Importe

Clique em **Importar (quantidade) Lead(s)**. No fim aparece quantos leads foram processados, quantos foram **criados** e quantos foram **atualizados**.

![Rodapé da janela de importação com os botões Voltar e Importar 3 Lead(s), este destacado.](https://crm.wavups.com/images/docs/leads-importar-mapeamento.png)

![Janela Importar Leads na etapa final, com o título 3 leads importados e os botões Importar outro arquivo e Concluir.](https://crm.wavups.com/images/docs/leads-importar-resultado.png)

*No fim, a janela mostra quantos leads foram importados. Clique em **Concluir** para voltar à lista.*

## Os campos que você pode importar

| Campo na importação | Como preencher |
| --- | --- |
| **Nome** | Obrigatório. Nome da pessoa ou da empresa. |
| **E-mail**, **CPF / CNPJ**, **Fonte**, **Descrição** | Texto livre, como está na planilha. |
| **Celular** | Com ou sem formatação. Números do Brasil são gravados só com os dígitos, com 55 e DDD. |
| **CEP**, **Estado**, **Cidade**, **Bairro**, **Endereço**, **Número**, **Complemento** | Texto livre. Na importação o endereço não é buscado pelo CEP. |
| **Status** | A situação do lead, com o texto exato que você quer ver (ex.: "Contatado", "Cliente"). |
| **Temperatura do Lead** | Use **1** para Frio, **2** para Morno e **3** para Quente. Texto (como "quente") fica vazio. |
| **Tipo de Lead** | Texto livre, que depois vira o filtro e a coluna **Tipo** da lista. |
| **Dono do Lead** | Só por **Valor fixo**: escolha um usuário da equipe e todos os leads da planilha ficam com ele. Ou deixe **Nenhum**. |

> **Use o valor fixo para marcar a origem**
> Importando a lista de um evento? Em **Fonte**, escolha **Valor fixo** e escreva "Feira 2026". Todos os leads entram com essa fonte, e depois você os encontra pelo filtro **Fonte**.

## Campos personalizados na importação

Os campos personalizados ativos da conta aparecem no fim da lista, na parte **Campos personalizados**, e são mapeados do mesmo jeito. No **Valor fixo**, o campo aparece no formato dele (lista de opções, calendário, Sim/Não). Os campos arquivados não aparecem.

| Tipo do campo | O que a planilha pode ter |
| --- | --- |
| **Data** | 15/03/2026, 15-03-2026, 15.03.2026, 15/03/26, 2026-03-15 ou a data do Excel. |
| **Número** e **Moeda (R$)** | 1234,56 ou 1.234,56 (também aceita ponto como decimal). |
| **Sim/Não** | sim, s, x, 1, verdadeiro, true ou yes para Sim; não, n, 0, falso, false ou no para Não. |
| **Seleção** | O nome de uma opção do campo. Maiúsculas e acentos não importam ("ouro" encontra "Ouro"). |
| **Seleção múltipla** | Os nomes das opções separados por vírgula, ponto e vírgula ou barra vertical (ex.: "Varejo; Atacado"). |
| **Texto**, **Email**, **Telefone**, **Link (URL)** | O texto como está na célula. |

Um valor que não combina com o tipo do campo (uma data impossível, uma opção que não existe) é **ignorado**, mas o lead é importado com o resto dos dados. No fim aparece o aviso **(quantidade) valor(es) de campos personalizados foram ignorados por não combinarem com o tipo do campo.**

## O que acontece com leads que já existem

- A WavUps CRM procura um lead da conta com o mesmo **CPF/CNPJ** e, se não achar, com o mesmo **celular** (comparando só os números).
- Se encontrar, o lead existente é **atualizado**: cada célula preenchida na planilha substitui o valor que estava no lead. Células vazias não apagam nada.
- Se só o **e-mail** coincidir, os dados da planilha completam apenas os campos vazios do lead existente.
- Duas linhas da mesma planilha com o mesmo CPF/CNPJ ou celular viram um lead só.

> **A importação pode sobrescrever dados**
> Como as células preenchidas substituem os dados do lead encontrado, confira a planilha antes de importar: uma coluna **Status** desatualizada, por exemplo, troca a situação de leads que já estavam sendo trabalhados. Se não quiser mexer num campo, escolha **Deixar vazio** para ele.

## Se algo der errado

| Mensagem ou situação | O que fazer |
| --- | --- |
| **Por favor, selecione um arquivo CSV ou XLSX válido.** | O arquivo não é CSV, XLSX ou XLS. Exporte a planilha num desses formatos. |
| **O arquivo deve conter pelo menos uma linha de dados.** | A planilha só tem o cabeçalho ou a primeira aba está vazia. |
| **Erro ao processar o arquivo. Verifique se o formato está correto.** | O arquivo está corrompido ou protegido por senha. Abra no Excel ou Google Planilhas e salve de novo. |
| **Os seguintes campos obrigatórios precisam ser mapeados: Nome** | Ligue o campo **Nome** a uma coluna da planilha. |
| **Nenhum lead foi importado com sucesso.** | Nenhuma linha pôde ser gravada. Confira se a coluna mapeada em **Nome** tem os nomes. |
| Foram processados menos leads do que linhas | Linhas sem nome são puladas. Se a sua conta mostra a cada pessoa só os próprios leads, linhas de contatos que já são de outro membro também são puladas. |

## Na prática

### Migração de outro sistema

**Situação:** Uma imobiliária exportou 3 mil clientes da planilha antiga, com uma coluna "Faixa de preço".

**Como a WavUps CRM ajuda:** O administrador cria o campo personalizado **Faixa de preço** (Seleção), importa a planilha e liga a coluna ao campo. Os leads chegam com a faixa já preenchida e prontos para filtrar.

### Lista de uma feira

**Situação:** Uma empresa de energia solar voltou de uma feira com 200 contatos numa planilha.

**Como a WavUps CRM ajuda:** Na importação, ela usa **Valor fixo** em **Fonte** ("Feira Solar 2026") e em **Dono do Lead** (a vendedora responsável). Depois seleciona todos e usa **Adicionar ao pipeline**.

### Atualização em lote

**Situação:** Uma escola precisa atualizar a cidade de centenas de alunos já cadastrados.

**Como a WavUps CRM ajuda:** Ela importa uma planilha só com **Nome**, **CPF / CNPJ** e **Cidade**. Como o CPF já existe, cada lead é atualizado, e os campos que ficaram em **Deixar vazio** não mudam.

## Perguntas frequentes

### Quais formatos de arquivo posso importar?

CSV, XLSX e XLS. Só a primeira aba da planilha é lida.

### A importação cria leads repetidos?

Não para quem tem CPF/CNPJ ou celular igual a um lead da conta: esse lead é atualizado. Se só o e-mail coincidir, os dados completam os campos vazios do lead existente.

### Posso definir o proprietário de cada linha pela planilha?

Na importação, o **Dono do Lead** é um valor fixo para todos os leads do arquivo. Para dividir entre vendedores, importe arquivos separados ou depois use a ação em massa **Proprietário**. Veja [Ações em massa nos leads](https://crm.wavups.com/docs/leads/acoes-em-massa).

### Como importo a temperatura dos leads?

Na coluna mapeada em **Temperatura do Lead**, use 1 para Frio, 2 para Morno e 3 para Quente.

### Uma célula vazia apaga o dado que o lead já tinha?

Não. Células vazias são ignoradas, tanto nos campos padrão quanto nos campos personalizados.

## Veja também

- [Como cadastrar um lead na WavUps CRM](https://crm.wavups.com/docs/leads/cadastrar-lead)
- [Como criar campos personalizados de leads na WavUps CRM](https://crm.wavups.com/docs/leads/campos-personalizados)
- [Como alterar vários leads de uma vez (ações em massa) na WavUps CRM](https://crm.wavups.com/docs/leads/acoes-em-massa)