Todos os Manuais Falar com Consultor Acessar o Painel
Módulo de Mailings e Contatos

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.

1

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.

https://app.ligoo.com.br/importar-arquivo
Demonstração

Importar Base de Contatos

Defina se deseja criar uma nova lista ou complementar uma existente, selecione o layout e carregue o arquivo.

Formatos Aceitos
Excel (.xlsx, .xls) e CSV (.csv)
Limite por Arquivo
Até 60 MB por lote seguro
Mapeamento
Padrão ou Layout Custom
Destino da Importação
Nova Base / Mailing
Criar um novo lote de contatos independente
Base Existente
Complementar lista já em execução
Mailing Vendas Novembro - Consignado SP
Mapeamento Padrão (Nome, Tel, CPF, Obs)
Ponto e vírgula (;)
O arquivo possui cabeçalho (Header) na primeira linha
mailing_vendas_novembro.xlsx
Arquivo selecionado (4.8 MB • Planilha Excel com 15.420 contatos)
Iniciar Importação
Orientações do Formulário:

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.

2

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.

https://app.ligoo.com.br/importar-arquivo/modal-pre-check
Demonstração
Decisão de Desduplicação & Políticas de Descanso:

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.

3

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.

https://app.ligoo.com.br/importar-arquivo/processando
Demonstraçã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.

4

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.

https://app.ligoo.com.br/importar-arquivo/sucesso
Demonstração

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.

5

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:

https://app.ligoo.com.br/importar-arquivo/erros-e-avisos
Demonstração
Alerta: Arquivo ultrapassa o limite máximo seguro de 60 MB

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.

Aviso: Coluna de Telefone não identificada no arquivo

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'.

Erro de Codificação: Arquivo não está em padrão UTF-8

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)'.

Dica de Suporte:

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