Importar leads por planilha
Cadastre vários leads de uma vez enviando uma planilha CSV ou Excel. Veja quais colunas usar, os valores aceitos e como fazer a importação.
Em vez de cadastrar um lead por vez, você pode importar vários de uma só vez a partir de uma planilha (.xlsx, .xls ou .csv). Cada linha da planilha vira um novo lead.
Como importar
- Acesse o menu Leads.
- Clique em Importar Leads.
- (Opcional) Baixe o modelo de importação para começar de uma base pronta: Excel (.xlsx) · Excel antigo (.xls) · CSV (.csv).
- Clique em Escolher arquivo e selecione sua planilha.
- Confira os cabeçalhos detectados e a quantidade de leads encontrados.
- Se aparecerem erros, corrija-os na planilha (eles indicam a linha com problema) e envie novamente.
- Clique em Importar para finalizar.
A primeira linha da planilha deve conter os nomes das colunas (o cabeçalho). Os leads começam a partir da segunda linha.
Colunas da planilha
Apenas nome e telefone são obrigatórios. As demais colunas são opcionais — se você não preencher, o Luno aplica um valor padrão.
| Coluna | Obrigatória? | O que preencher |
|---|---|---|
| nome | ✅ Sim | Nome do lead (até 60 caracteres) |
| telefone | ✅ Sim | Telefone ou WhatsApp com DDD (até 20 caracteres) |
| Não | E-mail do lead | |
| origem | Não | De onde veio o lead (ex.: Facebook, Indicação, Site) |
| qualificacao | Não | Quente, Morno, Frio ou Não qualificado |
| tipo de interesse | Não | Imóvel, Empreendimento, Locação ou Venda |
| cidade | Não | Cidade do lead |
| estado | Não | UF com 2 letras (ex.: SP, RJ, MG) |
| mensagem | Não | Observação ou mensagem do lead |
| passo | Não | Etapa do funil (número de 0 a 10) |
| corretorId | Não | Corretor responsável (campo avançado — veja abaixo) |
Os nomes das colunas aceitam variações. Por exemplo, telefone também pode se chamar
celular,contato; nome pode sernameoucliente. Não diferencia maiúsculas/minúsculas nem acentos.
Valores aceitos
Para as colunas com opções fixas, use um dos valores abaixo (pode escrever em português):
Qualificação
| Valor | Significado |
|---|---|
| Quente | Alto interesse e boa chance de fechar |
| Morno | Interesse moderado |
| Frio | Interesse baixo ou negociação distante |
| Não qualificado | Ainda falta informação ou interesse |
Tipo de interesse
| Valor | Significado |
|---|---|
| Imóvel | Interesse em um imóvel avulso |
| Empreendimento | Interesse em um empreendimento |
| Locação | Interesse em alugar |
| Venda | Interesse em comprar |
O que acontece com os campos vazios
Quando uma coluna opcional fica em branco, o Luno preenche automaticamente:
- origem → registrada como
IMPORT. Dica: se você escrever uma origem com o mesmo nome de uma origem já cadastrada na sua empresa, o lead é vinculado a ela automaticamente. - qualificacao → Não qualificado.
- tipo de interesse → Imóvel.
- passo → primeira etapa do funil (Novos).
- corretorId → o corretor que fez a importação.
Sobre a coluna "corretor" (corretorId)
O corretor responsável é opcional. Se você deixar a coluna corretorId em branco, todos os leads importados ficam com quem fez a importação.
Se quiser distribuir os leads entre corretores diferentes já na importação, preencha a coluna corretorId com o identificador do corretor. Esse é um campo avançado — na maioria dos casos, é mais simples deixar em branco e distribuir os leads depois pelo funil.
Pontos importantes
- Leads duplicados: cada linha vira um lead novo. A importação não verifica telefones repetidos, então evite enviar a mesma planilha duas vezes.
- Erros por linha: se algum dado estiver incorreto (ex.: nome vazio, UF com mais de 2 letras, qualificação inválida), a importação é bloqueada e o Luno mostra exatamente qual linha precisa ser corrigida.
- Formatos aceitos:
.xlsx,.xlse.csv.
Exemplo de planilha
| nome | telefone | origem | qualificacao | tipo de interesse | cidade | estado | |
|---|---|---|---|---|---|---|---|
| João Silva | (11) 99999-8888 | joao@email.com | Quente | Venda | São Paulo | SP | |
| Maria Souza | (21) 98888-7777 | Indicação | Morno | Locação | Rio de Janeiro | RJ | |
| Carlos Lima | (31) 97777-6666 |
No exemplo, o lead Carlos Lima só tem nome e telefone — o Luno completa o restante com os valores padrão.