Importação de Leads

phone_number,customer_name,company,budget_range,secondary_phone_1,secondary_phone_2
+14155551234,John Smith,ABC Corp,10k-50k,+14155551235,+14155551236
+14155557890,Jane Doe,XYZ Inc,50k-100k,+14155557891,
+14155554567,Bob Johnson,Tech Start,5k-10k,,
Seleção da Campanha
Escolher a Campanha de Destino
Selecione a campanha no momento da importação

Variáveis do assistente definem automaticamente as colunas esperadas

Herança de variáveis: Valores padrão do assistente aplicados a todos os leads

Mapeamento de Variáveis
As variáveis do assistente viram os cabeçalhos do arquivo

Valores padrão podem ser sobrescritos por lead

Flexibilidade para personalização individual

<Note> **Baixar arquivo de exemplo:** O modal de importação disponibiliza um CSV modelo com os cabeçalhos corretos conforme a campanha selecionada. </Note>
Etapas da Importação
1. Iniciar a Importação
Acesse a seção Leads ou a aba de leads da campanha

Clique em "Importar Leads"

Selecione a campanha

Baixe o arquivo modelo para validar o formato

2. Enviar o Arquivo
Escolha o arquivo: CSV ou Excel

Ignorar erros (opcional): Pular linhas inválidas

Revisar configurações

Clique em "Importar agora"

3. Processamento em Segundo Plano
Fila automática para arquivos grandes

Acompanhamento de progresso

Notificação por e-mail ao concluir

Relatório de erros disponível para download

Regras de Validação
Validação de Número de Telefone
Formato: Internacional recomendado (+1234567890)

Detecção de duplicados

Números inválidos são sinalizados e ignorados

Validação de Variáveis
Campos obrigatórios: Devem conter valor

Tipos de dados: Texto, número, booleano

Limites de tamanho respeitados

Validação de Contatos Secundários
Mesmo padrão de validação do número principal

Números únicos (não podem repetir o principal)

Variáveis avaliadas de forma independente

Tratamento de Erros
Ignorar Linhas Inválidas
Quando habilitado:

Linhas válidas são importadas

Linhas inválidas são descartadas

Relatório detalhado é gerado

Importação parcial é concluída com sucesso

Erros Comuns
Número de telefone inválido

Campos obrigatórios ausentes

Número duplicado

Arquivo corrompido ou formato não suportado

Relatório de Erros
Link de download ao final da importação

Descrição detalhada por linha

Orientações de correção

Possibilidade de reimportar os dados corrigidos

Importação de Contatos Secundários
Múltiplos Números por Lead
phone_number,customer_name,secondary_phone_1,secondary_phone_2,secondary_phone_3
+14155551234,John Smith,+14155551235,+14155551236,+14155551237
Variáveis para Contatos Secundários
phone_number,customer_name,secondary_phone_1,secondary_1_name,secondary_1_role
+14155551234,John Smith,+14155551235,Jane Smith,Decision Maker
Ordem de Contato
Contato principal: sempre chamado primeiro

Secundários: na ordem das colunas

Coordenação da campanha: respeita as regras de retry

Arquivos Grandes
Processamento em Background
Arquivos acima de 1000 linhas entram em fila

Processamento eficiente (streaming)

Sem impacto na performance da plataforma

Notificações
E-mail ao finalizar

Resumo de sucesso e erros

Links para relatórios

Tempo Estimado
< 100 linhas: até 1 minuto

100–1000 linhas: 2–5 minutos

1000+ linhas: 10–30 minutos

10k+ linhas: pode levar horas

Boas Práticas
Use o arquivo modelo

Padronize números no formato internacional

Limpe dados antes da importação

Teste com pequenos lotes

Garanta alinhamento das variáveis com o assistente

<Note> Para problemas comuns, veja [Solução de Problemas de Leads](/troubleshooting/leads). </Note> <Note> Para gerenciar leads importados, consulte [Gerenciamento de Leads](/leads/managing-leads). </Note> ```