Skip to main content
Importe grandes volumes de leads usando arquivos CSV ou Excel, com validação automática, processamento em segundo plano e relatórios detalhados de erro.

​
Visão Geral do Processo de Importação

O sistema de importação suporta:
  • Arquivos CSV e Excel (.csv, .xlsx, .xls)
  • Processamento em background para arquivos grandes
  • Validação automática com relatórios de erro
  • Contatos secundários no mesmo arquivo
  • Mapeamento de variáveis conforme o assistente configurado

​
Preparando o Arquivo de Importação

​
Colunas Obrigatórias

Seu arquivo deve conter:

​
Colunas Opcionais

  • Contatos secundários: Números adicionais
  • Sobrescrita de variáveis: Valores personalizados por lead

​
Exemplo de Formato do Arquivo

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
Baixar arquivo de exemplo: O modal de importação disponibiliza um CSV modelo com os cabeçalhos corretos conforme a campanha selecionada.
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
  1. Enviar o Arquivo Escolha o arquivo: CSV ou Excel
Ignorar erros (opcional): Pular linhas inválidas Revisar configurações Clique em “Importar agora”
  1. 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
Para problemas comuns, veja Solução de Problemas de Leads.
Para gerenciar leads importados, consulte Gerenciamento de Leads.
```