Importando Leads

​

Visão Geral do Processo de Importação

• 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 na mesma importação
• Mapeamento variável a partir da configuração do assistente

​

Preparando Seu Arquivo de Importação

​

Colunas Obrigatórias

• phone_number: Número de telefone do contato principal (obrigatório)
• Variáveis: Colunas que correspondem às suas variáveis configuradas do assistente

​

Colunas Opcionais

• Colunas de contato secundário: 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
+14155551234,John Smith,ABC Corp,10k-50k,+14155551235,+14155551236
+14155557890,Jane Doe,XYZ Inc,50k-100k,+14155557891,
+14155554567,Bob Johnson,Tech Start,5k-10k,,

​

Configuração de Importação

​

1. Selecionar Campanha

​

2. Contatos Secundários

​

3. Formato do Número de Telefone

• Números já incluem o código do país com o prefixo +
• Exemplo: +40741234567, +14155551234
• Nenhuma seleção de país necessária
• Pode misturar vários países no mesmo arquivo

• Números sem o prefixo do código do país
• Exemplo: 0741234567, 7775551234
• Deve selecionar o código do país durante a importação
• Importante: Separe seu arquivo por país - todos os números devem ser do mesmo país por arquivo
• O sistema adicionará o código do país selecionado a todos os números

​

4. Seleção do Código do País

​

Etapas de Importação

​

1. Iniciar Processo de Importação

1. Navegue até a seção Leads ou aba de leads da Campanha
2. Clique no botão “Importar Leads”
3. Selecione a campanha para atribuição de leads
4. Baixe o arquivo de exemplo para ver o formato esperado

​

2. Fazer Upload e Mapear Colunas

1. Escolha o arquivo: Selecione seu arquivo CSV ou Excel
2. Mapeamento de colunas: Mapeie as colunas do seu arquivo para os campos do sistema:
   • Número de Telefone (obrigatório): Selecione a coluna que contém os números de telefone
   • Variáveis do assistente: Mapeie cada variável para sua coluna correspondente
   • Contatos secundários: Se configurado, mapeie números de telefone e variáveis secundárias
3. Detecção automática: O sistema detecta automaticamente os mapeamentos com base nos nomes de cabeçalho comuns
4. Revisar e importar: Confirme os mapeamentos e clique em “Importar” para começar

​

3. Processamento em Segundo Plano

• Processamento em fila: Arquivos grandes são processados em segundo plano
• Acompanhamento de progresso: Atualizações de status de importação automaticamente
• Notificação: Notificação por e-mail quando a importação é concluída
• Relatório de erros: Baixe o relatório de quaisquer linhas com falha

​

Regras de Validação

​

Validação de Números de Telefone

• Verificação de formato: Formato internacional preferido (+1234567890)
• Detecção de duplicatas: Previne números de telefone duplicados
• Números inválidos: Marcados automaticamente e pulados

​

Validação de Variáveis

• Campos obrigatórios: Variáveis marcadas como obrigatórias devem ter valores
• Tipos de dados: Validação de texto, número, booleano onde aplicável
• Limites de comprimento: Limites máximos de caracteres aplicados

​

Validação de Contatos Secundários

• Formato de telefone: Mesma validação que números primários
• Números únicos: Contatos secundários devem diferir do primário
• Consistência de variáveis: Variáveis de contatos secundários validadas de forma independente

​

Tratamento de Erros

​

Tratamento Automático de Erros

• Linhas válidas importadas: Leads validados com sucesso são adicionados à campanha
• Linhas inválidas puladas: Linhas que falham na validação são automaticamente excluídas
• Relatório de erros gerado: Relatório detalhado de todas as linhas com falha é criado
• Sucesso parcial: A importação é concluída com sucesso com todos os leads válidos, linhas com falha são registradas

​

Erros de Validação Comuns

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

​

Download do Relatório de Erros

• Link de download fornecido na notificação
• Descrições detalhadas de erros para cada linha com falha
• Orientações de correção para resolver problemas
• Capacidade de reimportação com dados corrigidos

​

Importação de Contatos Secundários

​

Múltiplos Números de Telefone por Lead

phone_number,customer_name,secondary_phone_1,secondary_phone_2,secondary_phone_3
+14155551234,John Smith,+14155551235,+14155551236,+14155551237

​

Variáveis de Contato Secundário

phone_number,customer_name,secondary_phone_1,secondary_1_name,secondary_1_role
+14155551234,John Smith,+14155551235,Jane Smith,Decisor

​

Ordenação de Contatos

• Contato principal: Sempre chamado primeiro
• Ordem secundária: Chamados na ordem das colunas (secondary_phone_1, depois secondary_phone_2, etc.)
• Coordenação da campanha: Respeita as configurações de repetição da campanha entre os contatos

​

Manipulação de Arquivos Grandes

​

Processamento em Segundo Plano

• Fila automática: Arquivos com mais de 1000 linhas processados em segundo plano
• Eficiência de memória: Processamento em streaming previne timeouts
• Acompanhamento de progresso: Atualizações de status em tempo real
• Desempenho do sistema: Sem impacto no desempenho da plataforma durante a importação

​

Sistema de Notificação

• Notificações por e-mail: Enviadas quando a importação é concluída
• Resumo de sucesso: Número de leads importados com sucesso
• Resumo de erros: Contagem e detalhes das linhas com falha
• Links de download: Acesso a relatórios de erros e dados importados

​

Tempo de Processamento

• Arquivos pequenos (< 100 linhas): Geralmente concluídos em 1 minuto
• Arquivos médios (100-1000 linhas): 2-5 minutos típico
• Arquivos grandes (1000+ linhas): 10-30 minutos dependendo da complexidade
• Arquivos muito grandes (10k+ linhas): Podem levar várias horas

​

Melhores Práticas

• Use o arquivo de exemplo: Baixe o modelo fornecido para o formato correto
• Formato de telefone: Formato internacional sem separadores (+1234567890)
• Dados limpos: Remova linhas vazias e valide o conteúdo
• Teste primeiro: Comece com um pequeno lote para verificar o formato
• Combine variáveis: Certifique-se de que as colunas estejam alinhadas com a configuração do assistente