Importando Leads

Importe leads de arquivos CSV e Excel com validação e tratamento de erros Import leads from CSV and Excel files with validation and error handling

Importe grandes quantidades de leads de arquivos CSV ou Excel com validação automática, processamento em segundo plano e relatórios de erros completos.

Visão Geral do Processo de Importação

O sistema de importação de leads oferece suporte a:

• Arquivos CSV e Excel (.csv, .xlsx, .xls)
• Processamento em segundo plano para arquivos grandes
• Validação automática com relatórios de erros
• Contatos secundários no mesmo arquivo de importação
• Mapeamento de variáveis com base na configuração do assistente

Preparando Seu Arquivo de Importação

Colunas Obrigatórias

Seu arquivo de importação deve incluir:

• phone_number: número de telefone principal do contato (obrigatório)
• Variáveis: colunas correspondentes às variáveis configuradas no seu assistente

Colunas Opcionais

• Contatos secundários: números de telefone adicionais
• Substituições de variáveis: valores personalizados para leads específicos

Exemplo de Formato de Arquivo

phone_number,customer_name,company,budget_range,secondary_phone_1,secondary_phone_2
[phone],John Smith,ABC Corp,10k-50k,[phone],[phone]
[phone],Jane Doe,XYZ Inc,50k-100k,[phone],
[phone],Bob Johnson,Tech Start,5k-10k,,

Seleção de Campanha

Escolher Campanha de Destino

• Selecione a campanha no menu suspenso durante a importação
• As variáveis do assistente determinam automaticamente as colunas esperadas
• A herança de variáveis aplica os valores padrão do assistente a todos os leads importados

Mapeamento de Variáveis

• As variáveis do assistente se tornam os nomes das colunas no arquivo de exemplo
• Utiliza os valores padrão da configuração do assistente
• Permite substituir valores com informações personalizadas por lead

Baixar arquivo de exemplo: a janela de importação fornece um arquivo CSV de exemplo com os cabeçalhos corretos, baseados nas variáveis do assistente da campanha selecionada.

Etapas de Importação

1. Iniciar o Processo de Importação

1. Acesse a seção Leads ou a aba Leads da Campanha
2. Clique em “Import Leads”
3. Selecione a campanha para atribuição dos leads
4. Baixe o arquivo de exemplo para verificar o formato esperado

2. Enviar o Arquivo

1. Escolher arquivo: selecione seu arquivo CSV ou Excel
2. Opção “Ignorar erros”: ative para pular linhas inválidas
3. Revisar configurações: confirme a campanha e as opções
4. Iniciar importação: clique em “Import now” para começar

3. Processamento em Segundo Plano

• Fila de processamento: arquivos grandes são processados em segundo plano
• Acompanhamento de progresso: o status da importação é atualizado automaticamente
• Notificação: você receberá um e-mail quando a importação for concluída
• Relatório de erros: baixe o relatório com as linhas que falharam

---

Regras de Validação

Validação de Número de Telefone

• Verificação de formato: formato internacional preferido ([phone])
• Detecção de duplicados: impede números de telefone repetidos
• Números inválidos: sinalizados automaticamente e ignorados

Validação de Variáveis

• Campos obrigatórios: variáveis marcadas como obrigatórias devem conter valores
• Tipos de dados: validação de texto, número e booleano, quando aplicável
• Limite de comprimento: limites máximos de caracteres são aplicados

Validação de Contatos Secundários

• Formato do telefone: mesma validação dos números principais
• Números únicos: contatos secundários devem ser diferentes do principal
• Consistência de variáveis: variáveis de contatos secundários são validadas separadamente

---

Tratamento de Erros

Ignorar Linhas Inválidas

Quando a opção “Ignore errors” estiver ativada:

• Linhas válidas importadas: leads validados com sucesso são adicionados
• Linhas inválidas ignoradas: registros com erros são excluídos da importação
• Relatório de erros gerado: permite baixar um relatório detalhado das linhas com falha
• Sucesso parcial: a importação é concluída com o subconjunto válido

Erros Comuns de Validação

• Números de telefone inválidos: formato incorreto ou números impossíveis
• Campos obrigatórios ausentes: valores vazios em variáveis obrigatórias
• Números duplicados: número já existente no sistema
• Problemas de formato de arquivo: arquivo corrompido ou formato não suportado

Download do Relatório de Erros

Após a conclusão da importação:

• Um link de download será fornecido na notificação
• Inclui descrições detalhadas dos erros de cada linha com falha
• Fornece orientações para correção dos problemas
• Permite nova importação com os dados corrigidos

---

Importação de Contatos Secundários

Múltiplos Números por Lead

Inclua colunas adicionais para contatos secundários:

phone_number,customer_name,secondary_phone_1,secondary_phone_2,secondary_phone_3
[phone],John Smith,[phone],[phone],[phone]

Variáveis de Contato Secundário

Adicione variáveis específicas para contatos secundários:

phone_number,customer_name,secondary_phone_1,secondary_1_name,secondary_1_role
[phone],John Smith,[phone],Jane Smith,Decision Maker

Ordem de Contatos

• Contato principal: sempre é chamado primeiro
• Ordem secundária: chamadas seguem a ordem das colunas (secondary_phone_1, depois secondary_phone_2, etc.)
• Coordenação de campanha: respeita as configurações de repetição (retry settings) entre os contatos

Manipulação de Arquivos Grandes

Processamento em Segundo Plano

• Fila automática: arquivos com mais de 1000 linhas são processados em segundo plano
• Eficiência de memória: o processamento em fluxo (streaming) evita travamentos e timeouts
• Acompanhamento de progresso: o status da importação é atualizado em tempo real
• Desempenho do sistema: a importação não impacta o desempenho geral da plataforma

Sistema de Notificações

• Notificações por e-mail: enviadas quando a importação é concluída
• Resumo de sucesso: quantidade de leads importados com êxito
• Resumo de erros: contagem e detalhes das linhas com falha
• Links de download: acesso aos relatórios de erros e dados importados

Tempo de Processamento

• Arquivos pequenos (< 100 linhas): geralmente concluídos em até 1 minuto
• Arquivos médios (100–1000 linhas): levam de 2 a 5 minutos, em média
• Arquivos grandes (1000+ linhas): de 10 a 30 minutos, dependendo da complexidade
• Arquivos muito grandes (10k+ linhas): podem levar várias horas

Boas Práticas

• Use o arquivo de exemplo: baixe o modelo fornecido para garantir o formato correto
• Formato do telefone: utilize o formato internacional sem separadores ([phone])
• Limpeza de dados: remova linhas vazias e valide o conteúdo antes de importar
• Teste primeiro: comece com um lote pequeno para verificar se o formato está correto
• Correspondência de variáveis: garanta que as colunas estejam alinhadas com as variáveis do assistente

Para obter detalhes de solução de problemas e erros comuns de importação, consulte Leads Troubleshooting.

Para obter informações sobre como gerenciar leads importados, consulte Managing Leads.