Importação de Base de Contatos e Mailings
Acompanhe abaixo o fluxo sequencial completo de importação de planilhas Excel (.xlsx, .xls) e arquivos CSV no Ligoo Discador. Cada tela é apresentada exatamente na ordem cronológica em que aparece durante a execução, eliminando dúvidas e agilizando a alimentação das suas campanhas.
Passo 1: Formulário de Envio e Parâmetros da Base
O processo inicia na tela Mailings > Importar novo arquivo. Aqui você parametriza o destino dos contatos, o layout de colunas da planilha e o delimitador antes de fazer o envio.
Importar Base de Contatos
Defina se deseja criar uma nova lista ou complementar uma existente, selecione o layout e carregue o arquivo.
Se suas colunas já seguem o padrão (Nome na Coluna A, Telefone na Coluna B, etc.), mantenha o Mapeamento Padrão. Se você exportou de um CRM com as colunas em ordens diferentes, utilize o layout customizado previamente cadastrado em Mailings > Criar Layout.
Passo 2: Modal de Pré-Check, Validação e Regras de Descanso
Ao clicar em Iniciar Importação, o sistema não grava os dados de imediato. Ele executa uma validação em memória (POST /mailings/pre-check) e abre o modal de conferência. O modal apresenta três abas: Resumo & Regras, Colunas & Mapeamento e Prévia de Linhas.
Validação e Prévia da Base
O botão Importar Únicos é a opção recomendada para 99% das operações. Ele descarta registros repetidos da própria planilha e telefones já discados recentemente, garantindo que seu time de atendentes não ligue duas vezes para o mesmo cliente.
Passo 3: Acompanhamento do Progresso em Tempo Real
Assim que você clica em confirmar, o backend do Ligoo inicia a ingestão assíncrona com sanitização de telefones e validação de DDDs. A tela exibe a barra de progresso dinâmica com a contagem de linhas concluídas.
Importando Base de Contatos...
Processando 14.898 registros e higienizando telefones no servidor de alta vazão.
O recurso Continuar em Segundo Plano é ideal para mailings volumosos (acima de 100.000 contatos). O servidor continuará inserindo as linhas diretamente no banco de dados e notificará a conclusão no topo do sistema.
Passo 4: Sucesso, Relatório Consolidado e Liberação da Base
Ao atingir 100%, o modal é atualizado automaticamente com a confirmação de sucesso, exibindo o status oficial da lista e o balanço final de contatos gravados.
Importação Concluída com Sucesso!
A base Mailing Vendas Novembro foi validada, higienizada e gravada no discador preditivo.
Com a base no status Pronta para Discagem, você pode navegar até Campanhas > Nova Campanha (ou editar uma campanha existente) para vincular este lote à fila de atendimento e iniciar as chamadas.
Passo 5: Telas de Avisos, Inconsistências e Resolução de Erros
Caso o arquivo enviado apresente inconsistências de formatação, excesso de tamanho ou divergência de cabeçalho, o sistema interrompe o processamento preventivamente e exibe telas de alerta:
O arquivo selecionado possui 82 MB. O limite recomendado por requisição assíncrona é de 60 MB (aprox. 800.000 contatos). Solução: Divida a planilha em duas partes no Excel antes de importar.
A planilha possui colunas em ordem diferente da esperada pelo Layout Selecionado. Solução: Escolha um layout personalizado ou renomeie o cabeçalho para 'Telefone'.
Arquivos CSV salvos com formatações legadas podem desconfigurar nomes com acentuação. Solução: Salve o arquivo no Excel selecionando o formato 'CSV UTF-8 (delimitado por ponto e vírgula)'.
Se o discador indicar "0 telefones válidos encontrados", verifique se a coluna de telefone contém números com DDD (ex: 11988887777). Números com menos de 10 dígitos são automaticamente ignorados para evitar custos com discagens erradas.
Formatos Aceitos e Limites Técnicos
- Planilhas Excel: Extensões .xlsx ou .xls (leitura da primeira aba).
- Arquivos CSV: Texto delimitado por ponto e vírgula (;) ou vírgula (,).
- Higienização Automática: Não se preocupe em remover parênteses, espaços ou traços nos telefones. O importador do Ligoo sanitiza os dados automaticamente.
Dicionário de Campos do Formulário
| Campo | Tipo | Obrigatório | Descrição e Regra |
|---|---|---|---|
| Nome da Nova Base | Texto | Sim (se Nova Base) | Nome descritivo do lote (ex: "Consignado SP - Março"). |
| Base Existente | Seleção | Sim (se Existente) | Seleciona uma base ativa para inclusão incremental de novos contatos. |
| Layout de Importação | Seleção | Não | Define a ordem das colunas no arquivo (Padrão ou personalizado). |
| Possui Cabeçalho (Header) | Checkbox | Sim | Quando ativo, pula a primeira linha de títulos da planilha. |
| Delimitador | Seleção | Sim (p/ CSV) | Separador dos dados no CSV: Ponto e vírgula (;) ou Vírgula (,). |
| Descanso por Telefone | Toggle | Opcional | Quarentena de 30 dias para números já contactados recentemente. |
| Descanso por CPF | Toggle | Opcional | Evita contatar clientes com propostas já em andamento. |
Modelo de Arquivo CSV (Exemplo Padrão)
Abaixo está o layout padrão pronto para download e cópia direta:
Nome;Telefone;CPF;Observacao Carlos Eduardo Santos;11988887777;12345678900;Interessado em portabilidade Maria Helena Costa;21977776666;23456789011;Ligar apos as 14h Jose Ferreira Silva;31999990000;34567890122;Beneficio liberado margem consignavel