Preparar seu arquivo CSV (Comma Separated Values) corretamente é um passo fundamental para garantir uma importação de contatos bem-sucedida e sem dores de cabeça na ActiveCampaign. Um arquivo CSV formatado adequadamente permite que a plataforma reconheça seus dados de maneira precisa, mapeando as informações para os campos corretos e evitando erros ou dados perdidos.
Este guia detalha as melhores práticas e os requisitos essenciais para formatar seu arquivo CSV, assegurando que seus contatos e suas informações sejam transferidos para a ActiveCampaign de forma eficiente e organizada.
Antes de iniciar a importação, revise seu arquivo para garantir que ele atenda a estas diretrizes:
Codificação de Caracteres: UTF-8
Sempre salve seu arquivo CSV com a codificação UTF-8. Essa codificação é essencial para que caracteres especiais, como acentos, cedilhas (ç), e outros símbolos, sejam exibidos corretamente na ActiveCampaign e não apareçam como caracteres ilegíveis.
Na maioria dos programas de planilha (como Excel ou Google Sheets), a opção de salvar como "CSV UTF-8" está disponível na caixa de diálogo "Salvar como".
Formato de Valores Separados por Vírgula
O nome "CSV" significa "Comma Separated Values" (Valores Separados por Vírgula). Isso significa que cada campo de dados em uma linha deve ser separado por uma vírgula (,
).
Exemplo: nome,email,telefone
Alguns programas de planilha, especialmente em regiões que usam vírgula como separador decimal, podem salvar CSVs usando ponto e vírgula (;
) por padrão. Certifique-se de que o separador seja uma vírgula ou você precisará ajustar isso durante o processo de importação na ActiveCampaign.
Cabeçalhos de Coluna na Primeira Linha
A primeira linha do seu arquivo CSV deve conter os cabeçalhos de cada coluna. Esses cabeçalhos servem como rótulos para cada tipo de dado (ex: "Nome", "Email", "Telefone", "Cidade"). Eles facilitam o processo de mapeamento, ajudando a ActiveCampaign a entender qual dado de sua planilha corresponde a qual campo na plataforma.
Exemplo da primeira linha: Nome Completo,Email,Empresa,Telefone
Coluna de E-mail Obrigatória e Única
Cada contato que você deseja importar deve ter um endereço de e-mail válido em uma coluna dedicada. O e-mail é o identificador único para os contatos na ActiveCampaign. Se um contato não tiver um endereço de e-mail, ele não será importado.
A ActiveCampaign usará o e-mail para verificar duplicatas. Se você importar um contato com um e-mail já existente na sua conta, a ActiveCampaign atualizará o registro existente com os novos dados do CSV, em vez de criar um duplicado.
Todos os endereços de e-mail no arquivo precisam estar escritos e formatados corretamente para garantir a importação.
Valores do Campo de Data
Todos os valores de campos de data no seu CSV devem usar o formato YYYY-MM-DD
(Ano-Mês-Dia). Este formato usa apenas traços e não contém espaços nem barras (ex: 2023-01-15
). Se este formato não for seguido, os valores do campo serão definidos como uma data em 1899 na ActiveCampaign.
Múltiplas Tags para um Contato
Se um contato tiver várias tags que você deseja atribuir em uma única célula do CSV, separe-as por vírgula (,
).
Exemplo: Tag1,Tag2,Tag3
Vários Valores para um Campo (Caixas de Seleção e Listas Suspensas)
Para campos personalizados do tipo "Caixa de seleção" ou "Lista suspensa" que permitem múltiplos valores (ou seja, campos de seleção múltipla), use o delimitador de barra dupla (||
) entre as opções na célula.
Exemplo: Valor 1||Valor 2||Valor 3
Caracteres Especiais e Acentuados
Todos os valores em seu arquivo CSV que contenham caracteres especiais ou acentuados precisam estar entre aspas duplas ("
). Além disso, conforme mencionado, o arquivo CSV deve usar a codificação de caracteres UTF-8.
Exemplo: "João Silva","São Paulo"
Remova Quebras de Linha
Quebras de linha (breaks de texto dentro de uma célula) são relativamente comuns, mas não são aceitas pela ferramenta de importação da ActiveCampaign. Certifique-se de remover todas as quebras de linha do seu arquivo antes de importar. Para mais informações sobre como lidar com isso, consulte o artigo Erro ao importar um arquivo CSV.
Emojis
Emojis não podem ser usados durante uma importação de CSV no momento. Se você tentar importar um arquivo CSV com emojis nas células (por exemplo, Nome 🙂
), a importação inteira falhará. Certifique-se de remover todos os emojis antes de importar.
CSV é um formato de texto simples onde os valores são separados por um delimitador (geralmente vírgula). XLSX é o formato nativo do Microsoft Excel, que pode conter múltiplas planilhas, formatação complexa, fórmulas e outros elementos que não são suportados por importadores de CSV. Para importação de contatos, o CSV é o formato preferencial.
Certifique-se de que esses campos estejam formatados como "Texto" em sua planilha antes de salvar como CSV. Isso evita que programas como o Excel removam zeros à esquerda ou apliquem formatação numérica indesejada.
A ActiveCampaign geralmente aceita apenas um valor por campo. Se você tem vários telefones, por exemplo, e deseja mantê-los separados, precisará criar campos personalizados adicionais (ex: "Telefone 2", "Telefone Comercial").