SiteUp

Contatos

Importação de contatos em massa via CSV

Cadastre listas grandes de contatos de uma vez através de um arquivo CSV, com mapeamento automático de colunas, validações por linha e relatório de registros rejeitados.

Importação de contatos em massa via CSV

Quando há migração de outra ferramenta, recebimento de uma lista grande vinda de evento ou campanha, ou enriquecimento periódico vindo de outro sistema, cadastrar contato a contato é inviável. A importação via CSV resolve isso: você sobe um arquivo, o SiteUp processa em segundo plano e devolve um relatório com o que foi aceito e o que foi rejeitado.

Preparando o arquivo CSV

Antes de subir, garanta que o arquivo está no formato correto:

  • Codificação: UTF-8 (caracteres acentuados aparecem corretamente). Arquivos em outras codificações são convertidos automaticamente, mas podem perder caracteres.
  • Separador: vírgula (,).
  • Primeira linha: cabeçalho com o nome de cada coluna. As chaves devem coincidir com os campos padrão ou com a chave técnica de atributos personalizados.
  • Telefone: padrão internacional E.164 (+5511999999999). Linhas com telefone fora do formato são rejeitadas.

Colunas reconhecidas pelo sistema

Coluna Mapeia para
name Nome do contato
email E-mail (único por conta)
phone_number Telefone em E.164 (único por conta)
identifier Identificador externo (único por conta)
additional_attributes.company_name Empresa
additional_attributes.city Cidade
additional_attributes.country País
Qualquer outra coluna Tratada como atributo personalizado, desde que a chave técnica exista

Exemplo mínimo

name,email,phone_number,identifier
Maria Silva,maria@exemplo.com.br,+5511988887777,CRM-001
João Santos,joao@exemplo.com.br,+5521977776666,CRM-002

Exemplo com atributos personalizados

name,email,phone_number,cnpj,plano,origem_lead
Maria Silva,maria@exemplo.com.br,+5511988887777,12345678000199,Pro,site
João Santos,joao@exemplo.com.br,+5521977776666,98765432000111,Enterprise,evento

Atenção: crie os atributos personalizados em Configurações → Atributos personalizados antes de importar. Colunas correspondentes a chaves inexistentes são simplesmente ignoradas e os dados se perdem.

Subindo o arquivo

  1. Acesse Contatos no menu lateral.
  2. Clique no menu de três pontos no canto superior direito → Importar contatos.
  3. Arraste o arquivo CSV ou clique para selecioná-lo.
  4. Confirme o envio.

O upload é registrado e a importação roda em segundo plano. Você pode fechar a tela e voltar depois.

Como funciona a deduplicação

O SiteUp aplica restrições de unicidade nos campos email, phone_number e identifier dentro da conta. Durante a importação:

Situação Resultado
Linha com email, telefone ou identifier que já existe Linha ignorada — o contato existente não é alterado.
Linha com identificadores totalmente novos Contato é criado.
Linha sem nenhum identificador único, apenas name Contato é criado, mas sem identificadores, ficando vulnerável a futura duplicação.

A importação não atualiza contatos existentes. Se você precisa enriquecer cadastros já presentes na base, faça-o pela API pública ou pela edição manual — não pela importação CSV.

Validações executadas

Cada linha passa pelas mesmas validações do cadastro manual antes de ser inserida. Linhas inválidas vão para um relatório de erros e não interrompem a importação. Os erros mais comuns são:

  • E-mail com formato inválido (sem @ ou domínio).
  • Telefone fora do padrão E.164 (ausência do + ou caracteres não numéricos).
  • Atributo de tipo número recebendo texto.
  • Atributo de tipo lista suspensa recebendo valor não previsto.
  • Linha duplicada dentro do próprio CSV.

Acompanhando e revisando

Quando a importação termina, o administrador da conta recebe um e-mail com:

  • Total de registros processados.
  • Quantos foram criados com sucesso.
  • Quantos foram rejeitados.
  • Link para download do CSV de erros — uma cópia do arquivo original contendo apenas as linhas problemáticas, com uma coluna errors explicando o motivo de cada falha.

Use esse arquivo para corrigir os dados e reimportar apenas o que foi rejeitado.

Boas práticas

  • Faça um teste pequeno primeiro — suba 10 linhas para validar o mapeamento antes de subir 10 000.
  • Padronize antes de subir — corrija telefones e e-mails no Excel, Google Sheets ou em um pré-processamento. Importar lixo gera lixo.
  • Crie os atributos antes — nada é mais frustrante do que descobrir que os dados foram ignorados porque a chave técnica não existia.
  • Guarde o CSV original — em caso de problema é mais rápido reanalisar do que reconstruir.
  • Atenção à LGPD — só importe contatos para os quais sua empresa tem base legal de tratamento (consentimento, execução de contrato, legítimo interesse documentado).

Próximos passos

Esse artigo respondeu sua duvida?

Falar com o time