👥Contatos & Segmentação
⏱️ 8 min de leitura📊 Fundamental

Como Importar Contatos via Planilha CSV ou Excel (Passo a Passo com Higienização)

Guia definitivo para subir listas de contatos no Painel V2 com normalização automática de DDI/DDD, validação de 9º dígito brasileiro, desduplicação inteligente, mapeamento de campos personalizados e conformidade com o algoritmo de risco Reacher.

⚡Pré-requisitos Obrigatórios & Checklist Inicial

  • ✓Arquivo de contatos salvo nos formatos .csv, .xlsx ou .xls (tamanho máximo recomendado: 50MB ou 100.000 linhas por arquivo).
  • ✓A planilha deve conter pelo menos uma coluna com o número de WhatsApp/celular ou e-mail de cada contato.
  • ✓Base de contatos legítima com consentimento prévio (opt-in) — listas compradas ou raspadas da internet violam os Termos de Uso e acionam suspensão automática.

📋Instruções Passo a Passo no Painel

01

Acessar a Área de Contatos e Iniciar o Assistente de Importação

👉 Onde Clicar:Menu Lateral Esquerdo > Contatos > Botão Superior 'Importar Contatos'

Na tela de Contatos, você verá a listagem geral dos seus clientes e leads com filtros rápidos por tags e status. No topo direito, clique no botão azul 'Importar Contatos'. O sistema abrirá o Assistente de Importação em 3 etapas guiadas.

02

Etapa 1: Upload do Arquivo e Verificação de Integridade

👉 Onde Clicar:Assistente de Importação > Etapa 1: Arquivo

Arraste e solte o arquivo da sua planilha na caixa pontilhada ou clique em 'Selecionar Arquivo do Computador'. O motor do MailerWeb inspeciona a assinatura de bytes do arquivo para garantir que não se trata de um arquivo corrompido ou disfarçado. O painel exibirá uma prévia imediata das primeiras 5 linhas para você confirmar que os dados foram lidos corretamente.

03

Etapa 2: Mapeamento Inteligente de Colunas e Campos Personalizados

👉 Onde Clicar:Assistente de Importação > Etapa 2: Mapeamento de Colunas

O sistema tenta auto-detectar colunas como Nome, Telefone, E-mail e Empresa. Para cada coluna da sua planilha, selecione o campo correspondente no MailerWeb:

Dicionário de Campos & Parâmetros:
Telefone / Celular (Obrigatório para WhatsApp)Mapeie a coluna com os números. O sistema aceita qualquer formato: (11) 98765-4321, 11987654321 ou +5511987654321. O normalizador adiciona o DDI +55 e o 9º dígito automaticamente caso falte.
Nome CompletoMapeie para o campo 'Nome'. Você poderá usar {{contact.first_name}} nas mensagens para saudar o cliente pelo primeiro nome.
E-mailMapeie para campanhas de e-mail e validação de MX de segurança.
Campos Personalizados (Custom Fields)Dados específicos como 'Data de Aniversário', 'Valor da Compra', 'Plano Atual' ou 'Vendedor Responsável' podem ser vinculados a campos customizados criados previamente na sua conta.
04

Etapa 3: Regras de Desduplicação, Tags e Execução em Segundo Plano

👉 Onde Clicar:Assistente de Importação > Etapa 3: Configurações Finais

Defina como o MailerWeb deve tratar contatos que já existem na sua base e aplique etiquetas em lote para organizar os novos registros.

Dicionário de Campos & Parâmetros:
Chave de DesduplicaçãoEscolha entre 'Apenas Telefone', 'Apenas E-mail' ou 'Telefone e E-mail'. Se um contato já existir, você pode escolher 'Atualizar dados existentes' ou 'Pular duplicados'.
Vincular a uma ListaAdiciona os contatos automaticamente a uma lista estática (ex: 'Clientes Black Friday 2026', 'Leads Webinar Gestão').
Aplicar TagsInsira uma ou mais tags separadas por vírgula (ex: inbound, organico, vip).
Modo de ImportaçãoPadrão: 'Ativos' (novos contatos aptos a receber mensagens); 'Opt-out / Supressão' (cadastrar números na lista de bloqueio para nunca enviar mensagens); 'Remoção' (excluir contatos da planilha da base).
05

Acompanhar o Processamento e Baixar Relatório de Higienização

👉 Onde Clicar:Contatos > Histórico de Importações

A importação é processada em segundo plano pelos servidores assíncronos do MailerWeb em lotes de 5.000 contatos. Você pode fechar o navegador sem interromper o processo. Ao finalizar, o painel exibe a contagem exata de: Contatos criados, Contatos atualizados, Duplicados ignorados e Linhas rejeitadas por telefone inválido. Você pode clicar em 'Baixar Relatório de Rejeições' para auditar números que apresentaram erro de digitação.

🚨Regras Críticas de Segurança & Proteção Anti-Bloqueio

  • 🛡️Gatilho Anti-Fraude Reacher (>15% de Rejeição): Se a sua planilha contiver mais de 15% de números inexistentes, telefones fixos disfarçados ou e-mails com domínio inválido, o sistema congela a importação e suspende preventivamente a conta para proteger a reputação dos seus números de WhatsApp contra denúncias de SPAM.
  • 🛡️Higienização de Lista Antiga: Antes de importar bases antigas (com mais de 6 meses sem contato), passe os dados por um higienizador prévio ou faça o envio fracionado.
  • 🛡️Opt-in Obrigatório pela LGPD: É terminantemente proibido importar bases de dados obtidas de terceiros, compradas ou coletadas sem permissão expressa do titular.

❓Perguntas Frequentes & Resolução de Dúvidas

P:Como o MailerWeb corrige números sem o dígito 9?

O normalizador interno identifica o DDD brasileiro e aplica o dígito 9 automaticamente em celulares que foram digitados com 8 dígitos, evitando descarte indevido.

P:Posso importar contatos diretamente de um grupo de WhatsApp?

Sim! No menu Comunidades > Meus Grupos, você pode selecionar qualquer grupo onde você seja administrador e clicar em 'Extrair e Importar Membros' para salvá-los como contatos no painel.

P:Existe limite de contatos por conta?

O limite de contatos armazenados depende do plano contratado (ex: Starter possui até 10.000 contatos; Unlimited possui contatos ilimitados). Verifique no menu Faturamento.

MailerWeb Knowledge Base • Atualizado em 2026 • Documentação Oficial do Usuário