Importação CSV: detecção de colunas e estratégia de duplicados

Envie um CSV e deixe o Omnifox detectar suas colunas automaticamente; decida o que fazer com contatos repetidos.

Jun 26, 2026

O assistente de importação CSV guia você em quatro etapas —Enviar, Mapear colunas, Prévia e Importar— para carregar sua lista de contatos. O Omnifox tenta reconhecer suas colunas automaticamente e deixa você decidir o que fazer quando um contato já existe.

Antes de começar

  • Prepare um arquivo CSV (máximo 10 MB) com uma linha de cabeçalho e uma linha por contato.
  • Cada contato precisa de ao menos um dado identificável: email, telefone ou nome.

Passos

  1. Abra Contatos e clique em Importar CSV.
  2. Etapa 1 — Enviar: arraste o arquivo ou clique em Escolher arquivo. O Omnifox mostra o nome, o tamanho e quantas linhas detectou.
  3. Etapa 2 — Mapear colunas: cada coluna do seu CSV é associada a um campo do Omnifox (nome, sobrenome, email, telefone, empresa, cargo, país, cidade, idioma, gênero, notas…).
    • A detecção automática reconhece cabeçalhos comuns em português, espanhol e inglês: nome/firstname, email/correo, telefone/celular/phone, empresa/company, cargo/title, pais, cidade, entre outros.
    • Se uma coluna não deve ser importada, deixe-a em -- Ignorar esta coluna --.
  4. Escolha a estratégia de duplicados (um contato é considerado duplicado quando o email ou o telefone coincide):
    • Atualizar contato existente: sobrescreve os dados do contato que já estava cadastrado.
    • Ignorar duplicados: mantém o contato existente e descarta a linha repetida.
  5. Etapa 3 — Prévia: revise as primeiras linhas mapeadas. As que tiverem problemas (email inválido ou sem nenhum campo identificável) aparecem marcadas como aviso.
  6. Etapa 4 — Importar: confirme. Você verá um resumo com Contatos criados, Contatos atualizados e Erros.

Verificação

Ao terminar, volte a Contatos: seus registros novos já aparecem na lista. Se houve linhas com erro, você pode baixar o relatório de erros em CSV para corrigi-las e tentar novamente apenas essas.

Se não funcionar

  • "O arquivo CSV deve conter pelo menos uma linha de cabeçalho e uma de dados": seu arquivo está vazio ou só tem cabeçalhos.
  • Linhas ignoradas: uma linha é pulada se a quantidade de colunas não coincide com a do cabeçalho. Verifique vírgulas ou quebras de linha dentro dos valores.
  • Importações grandes: se o arquivo passar de 500 linhas, a importação roda em segundo plano e você recebe uma notificação ao concluir.
  • Uma coluna não é detectada: mapeie-a manualmente na etapa de mapeamento; a detecção automática cobre apenas os nomes de cabeçalho mais comuns.

Dicas

  • Antes de importar, padronize os telefones em formato internacional para evitar duplicados não detectados.
  • Use Atualizar contato existente para enriquecer sua base com dados novos sem perder os contatos anteriores.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp