Importando Leads

Você pode importar leads em massa a partir de um arquivo CSV para o seu workspace. O importador mapeia colunas CSV para campos de lead e cria os registros em segundo plano.

---

Passo 1 — Prepare Seu CSV

Seu arquivo CSV deve:

• Ter uma linha de cabeçalho (nomes das colunas na primeira linha)
• Usar codificação UTF-8
• Ser separado por vírgulas (não por tabulação ou ponto e vírgula)

Colunas Suportadas

Mapeie suas colunas CSV para esses campos de lead:

Nome da Coluna CSV (sugerido)	Campo do Lead
first_name	Primeiro Nome
last_name	Sobrenome
email	E-mail
phone	Telefone
company	Nome da empresa (cria uma empresa se não existir)
status	Status (new, contacted, qualified, converted, lost)
source	Fonte do lead
lead_score	Pontuação
deal_value	Valor do Negócio
tags	Nomes de tags separados por vírgula
notes	Notas (texto simples)

Qualquer coluna não reconhecida é ignorada. Colunas não mapeadas podem ser mapeadas manualmente durante a importação.

---

Passo 2 — Iniciar a Importação

1. Acesse Leads → Importar Leads na barra lateral.
2. Clique em Nova Importação.
3. Faça upload do seu arquivo CSV.

---

Passo 3 — Mapear Colunas

O importador exibe uma prévia do seu CSV e permite mapear cada coluna para um campo de lead:

1. Para cada coluna CSV, selecione o campo de lead correspondente no dropdown.
2. Colunas que você deseja ignorar: deixe como "Não importar".
3. Revise a linha de exemplo para confirmar que o mapeamento está correto.
4. Clique em Iniciar Importação.

---

Passo 4 — Monitorar o Progresso

A importação é executada em segundo plano (via fila). Uma barra de progresso mostra:

• Total de linhas
• Linhas processadas
• Importações bem-sucedidas
• Linhas ignoradas (duplicatas ou dados inválidos)
• Erros

---

Tratamento de Duplicatas

• Se um lead com o mesmo e-mail já existir no seu workspace, a linha é ignorada (não atualizada).
• Linhas sem e-mail são importadas como novos leads.

---

Histórico de Importações

Todas as importações anteriores estão listadas em Leads → Importar Leads. Clique em qualquer importação para ver seu status e detalhes de erros.

---

Problemas Comuns

Problema	Solução
"Formato CSV inválido"	Certifique-se de que o arquivo está codificado em UTF-8 e separado por vírgulas
Muitas linhas ignoradas	Verifique e-mails duplicados no seu workspace
Campos não estão sendo mapeados	Verifique a ortografia da linha de cabeçalho; mapeie manualmente na tela de mapeamento
Importação travada	Verifique se o cron job está funcionando (Super Admin → Saúde do Sistema)

---

Dicas

• Sempre teste com um arquivo pequeno (10-20 linhas) antes de importar milhares de leads.
• Inclua status no seu CSV para evitar que todos os leads fiquem como "Novo".
• Use valores de source consistentes para poder filtrar por fonte após a importação.