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

Acesse Contatos no menu lateral.
Clique no menu de três pontos no canto superior direito → Importar contatos.
Arraste o arquivo CSV ou clique para selecioná-lo.
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

Atributos personalizados — criar campos antes de importar.
Mesclar duplicatas — limpar registros que escaparam da deduplicação.
Segmentos dinâmicos — segmentar a base recém-importada.