# Como importar leads por uma planilha CSV
Quando a imobiliária recebe uma lista de interessados de fora do sistema — como o resultado de uma campanha, uma planilha de um evento ou uma base exportada de outra ferramenta — cadastrar cada lead manualmente pode se tornar inviável. A importação permite ler um arquivo e criar vários leads de uma só vez, já com a origem definida e prontos para serem trabalhados. A seguir, veja o passo a passo.
---
##### **Navegação no Módulo**
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/entrandoleads.gif)
**Rotina:** Pessoas > **Leads** > menu de **opções** (canto superior direito) > **Importar Leads**
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/SAhimage.png)
Será aberta a janela **Importador de Leads via arquivo CSV**.
---
##### **Preparar o arquivo**
Antes de iniciar a importação, o arquivo deve atender aos seguintes requisitos:
| Requisito
| Descrição
|
|---|
| **Formato CSV**
| O arquivo utilizado na importação deve estar no formato CSV.
|
| **Codificação UTF-8**
| Garante que acentos, cedilhas e outros caracteres especiais sejam importados corretamente.
|
| **Até 1.000 leads por vez**
| Cada importação aceita no máximo 1.000 registros. Para listas maiores, divida o arquivo em partes.
|
O arquivo pode conter informações como **data, finalidade, nome, e-mail, telefone, observações, código do imóvel, origem, detalhes da origem e status**.
Não é obrigatório possuir todas essas colunas, nem seguir uma ordem específica, pois a associação entre as colunas e os campos do sistema será realizada posteriormente.
A finalidade é reconhecida tanto em português quanto em inglês, mas precisa corresponder às opções disponíveis no sistema — venda, aluguel, temporada ou permuta. Valores fora dessa lista não são aproveitados.
---
##### **Aba Arquivo — enviar e configurar**
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/EAuimage.png)
Na primeira etapa, selecione o arquivo e defina como ele deve ser interpretado pelo sistema.
| Campo / Opção
| Descrição
|
|---|
| **Arquivo CSV**
| Selecione o arquivo que contém os leads que serão importados.
|
| **Origem**
| Define uma origem que será aplicada a
**todos**
os leads do arquivo. Essa informação pode ser utilizada posteriormente para identificar o resultado daquela lista ou campanha.
|
| **Separador de coluna**
| Define como as informações estão separadas no arquivo, como ponto e vírgula, vírgula, tabulação ou espaço.
|
| **A primeira linha é um cabeçalho**
| Ative quando a primeira linha do arquivo contiver o nome das colunas, e não os dados de um lead.
|
| **Desativar notificações ao gerar negócio**
| Evita o envio de uma grande quantidade de notificações para a equipe quando os leads importados originarem negócios.
|
Depois de configurar as opções, clique em **Processar arquivo**.
---
##### **Aba Mapeamento — identificar as colunas**
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/JYtimage.png)
Após processar o arquivo, o sistema apresenta cada coluna encontrada para que seja definido a qual informação do lead ela corresponde.
Por exemplo, uma coluna do arquivo pode ser associada ao **Nome**, outra ao **Telefone**, outra ao **E-mail**, **Finalidade**, **Origem** e assim por diante.
Colunas que não precisam ser aproveitadas podem permanecer sem associação e não serão importadas.
Abaixo do mapeamento, o sistema apresenta uma **prévia das primeiras linhas do arquivo**, permitindo conferir se os dados estão relacionados aos campos corretos antes de continuar.
Confira a prévia antes de importar. Caso um telefone esteja sendo apresentado no campo de e-mail, por exemplo, ajuste o mapeamento da coluna antes de prosseguir.
---
##### **Importar os leads**
[](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/52Oimage.png)
Depois de conferir o mapeamento, clique em **Importar Leads**.
O sistema processará os registros do arquivo e, ao final, apresentará um resumo com:
---
##### **Comportamentos específicos da importação**
Leads importados possuem alguns comportamentos diferentes daqueles recebidos diretamente pelo site, portais ou integrações.
| Comportamento
| Descrição
|
|---|
| **Duplicados são ignorados**
| Se já existir um lead com o mesmo nome, telefone e e-mail, o registro do arquivo não é criado novamente.
|
| **Não geram notificações individuais**
| A equipe não recebe uma notificação para cada lead importado.
|
| **Não geram eventos de conversão de campanha**
| A importação não é contabilizada como uma conversão de anúncio.
|
| **Identificação de importado**
| Os leads ficam identificados como importados por meio de um selo próprio na ficha.
|
---
##### **Depois da importação**
Depois de importados, os leads passam a fazer parte da listagem e seguem o fluxo normal de atendimento da imobiliária.
| Situação
| O que acontece
|
|---|
| **Distribuição automática (rodízio) ativa**
| Os leads podem ser encaminhados automaticamente aos corretores conforme as regras configuradas.
|
| **Sem distribuição automática**
| Os leads permanecem disponíveis para que a equipe faça o atendimento e a conversão em negócio manualmente.
|
A conversão manual é detalhada na documentação **Como enviar o lead e criar negócio para o corretor?**
Ao importar uma lista grande com o rodízio ativado, existe um limite de leads distribuídos automaticamente por hora, proporcional ao número de usuários do plano. Quando esse limite é atingido, a distribuição pausa e continua na hora seguinte. Os leads não são perdidos, apenas podem levar mais tempo para chegar aos corretores.
---
#### **Perguntas frequentes**
➜ **Quantos leads posso importar de uma vez?** Até **1.000 leads por importação**. Para listas maiores, divida o arquivo em partes e realize mais de uma importação.
➜ **Os acentos vieram errados. O que aconteceu?** Provavelmente o arquivo não foi salvo em **UTF-8**. Reexporte ou salve novamente o CSV utilizando essa codificação e faça uma nova importação.
➜ **Alguns leads não foram importados. Por quê?** As causas mais comuns são registros duplicados ou linhas com algum erro. O resumo exibido ao final da importação informa quantos leads não puderam ser processados.
➜ **Preciso que o arquivo tenha as colunas em uma ordem específica?** Não. As colunas são associadas manualmente aos campos do sistema na aba **Mapeamento**.
➜ **Posso definir uma origem diferente para cada lead?** Sim, desde que o arquivo tenha uma coluna de origem e ela seja associada corretamente durante o mapeamento. O campo **Origem** da primeira etapa aplica a mesma origem para todos os registros.
➜ **A importação avisa os corretores?** Não individualmente. Além disso, existe a opção de desativar as notificações geradas durante a criação de negócios, recomendada para importações maiores.
➜ **Importar cria a pessoa no cadastro de contatos?** Não. A importação cria apenas o **lead**. O cadastro da pessoa é criado ou reaproveitado posteriormente, durante a conversão do lead em negócio.