Como formatar seu arquivo de importação de contatos

Neste artigo, vamos explicar como formatar seu arquivo de importação de contatos.

Quando você importa contatos para a Sendinblue, os dados de seu arquivo de importação serão vinculados a atributos de contato em sua conta Sendinblue. Alguns tipos de atributos de contato, como EMAIL e SMS, requerem um formato específico para serem importados corretamente.

Antes de começar

  • Pelo menos o atributo EMAIL (para campanhas de e-mail) ou SMS (para campanhas de SMS) é obrigatório em seu arquivo de importação. Outros atributos são opcionais, mas podem ser necessários para personalizar seus e-mails ou segmentar seus contatos.
  • Existem 4 atributos padrão na Sendinblue quando você cria uma conta: FIRSTNAME, LASTNAME, EMAIL e SMS. Os atributos padrão FIRSTNAME e LASTNAME podem variar com base no idioma da conta selecionado por você durante a criação de sua conta.
  • Saiba mais sobre os diferentes tipos de atributos em Atributos de diferentes campos de sua base de dados.

Tipos de arquivo

Os seguintes tipos de arquivo são compatíveis para importar seus contatos para a Sendinblue:

  • .CSV (Microsoft Excel, Open Office Calc, Google Spreadsheets)
  • .XLSX (Microsoft Excel open format)
  • .TXT (Microsoft Notepad)

Estrutura do arquivo

Cabeçalhos da coluna

Cabeçalhos da coluna são opcionais, mas tornam mais fácil para nosso sistema vincular seus dados a atributos de contato correspondentes. Cada coluna em seu arquivo precisa de um nome único e você pode arrumá-los em qualquer ordem. Para simplificar a importação, use os nomes dos seus atributos de contato como os cabeçalhos em seu arquivo. Se você não incluir cabeçalhos de colunas em seu arquivo de importação, vai precisa vincular manualmente cada coluna com um atributo de contato.

mceclip1.png

Delimitador

Cada valor em seu arquivo de importação deve ser separado por um ponto e vírgula ;, uma vírgula , ou um espaçamento       . Não especificar um delimitador resultará em uma falha no carregamento, uma vez que nosso sistema não será capaz de reconhecer cada valor.

Endereços de e-mail

Para importar um endereço de e-mail de contato, use o atributo padrão EMAIL como seu cabeçalho da coluna. Se um contato não tiver um endereço de e-mail, criaremos um endereço de e-mail fictício durante a importação. Este endereço de e-mail fictício não será utilizável, mas será único para cada contato. Isso seguirá o formato SMSNumber@mailin-sms.com. Se depois você encontrar o endereço de e-mail do seu contato, sempre pode substituir os endereços de e-mail fictícios criados pelo real.

mceclip0.png

Números de SMS

Para importar o número SMS de um contato, use o atributo padrão SMS como cabeçalho da sua coluna. Sempre inclua o sinal + e o código do país para cada número SMS, e não separe os dígitos nos números SMS por nenhum caractere especial.

mceclip3.png

Texto

Atributos do tipo texto são usados para armazenar uma string de quaisquer caracteres alfanuméricos, tal como uma palavra, uma frase ou uma sentença. Você pode usar um atributo do tipo texto para importar dados adicionais, tais como preferências de idioma, cor favorita, ou nome da empresa do contato. Quando usados em um arquivo de importação, atributos do tipo Texto não têm limites de caracteres.

mceclip4.png

Número

Atributos do tipo número são usados para armazenar uma string de numerais ou números escritos em decimais. Você pode usar um atributo de número para importar valores numéricos ou monetários para seus contatos.

mceclip5.png

Booleano

Atributos do tipo Booleano são usados para armazenar valores que só podem conter Sim ou Não como valor.
Por exemplo, se você tem um valor opt-in, você pode criar um atributo do tipo Boolean chamado OPT_IN, o qual só pode conter vazio, Sim ou Não como valores.
mceclip6.png

Categoria

Atributos do tipo Categoria são usados para armazenar valores que só podem conter apenas um valor de um conjunto definido de valores possíveis.

Por exemplo, se você tiver um valor gênero, você pode criar um atributo do tipo Categoria, chamado GÊNERO, e definir valores possíveis como “Feminino”, “Masculino” ou “Desconhecido”. O atributo GÊNERO de cada contato conterá apenas um valor entre “Feminino”, “Masculino” ou “Desconhecido”.

Em seu arquivo de importação, inclua apenas o número ID da opção da categoria. Por exemplo, você pode ter:

  • 1 se o atributo GÊNERO for “Feminino”
  • 2 se o atributo GÊNERO for “Masculino”
  • 3 se o atributo GÊNERO for “Desconhecido"

mceclip7.png

Data

Atributos do tipo Data são usados para armazenar um valor de data. Mantenha o formato do valor neste atributo similar ao formato selecionado nas configurações de sua conta (DD-MM-AAAA ou MM-DD-AAAA).
mceclip8.png

Exemplos de arquivos de importação

Exemplo .CSV

  • Cada contato deve ter sua própria linha.
  • Cada coluna deve incluir um único pedaço de informação.

mceclip2.png

Exemplo .TXT

  • Cada contato deve ter sua própria linha.
  • Separe cada valor por um ponto e vírgula ;, uma vírgula , ou um tab       .

mceclip3.png

Amostra de arquivo de importação

Para ajudar você a formatar seu arquivo de importação, criamos 3 amostras de arquivos de importação que você pode baixar:

Depois de atualizar a amostra do arquivo com as informações dos seus contatos e de salvar isso, aprenda como Importar seus contatos para a Sendinblue.

Tamanho do arquivo

O maior tamanho de arquivo que pode ser importado para sua conta Sendinblue é 250 MB. Mas não há limite no número de contatos que você pode importar de uma vez só.

Codificação do arquivo

Só aceitamos dois tipos de codificação de arquivo, UTF-8 e Windows-1252. Estas codificações possibilitam ler o conteúdo do seu arquivo quando ele contém caracteres especiais.

Caso você encontre o seguinte erro "A codificação dos arquivos importados não é suportada. Suportamos principalmente UTF-8 como formato de codificação do arquivo" devido a codificação inválida do arquivo, siga as etapas abaixo para salvar seu arquivo como UTF-8.

blobid0.png

Codificando um arquivo em UTF-8 com o Microsoft Excel

  1. Abra seu arquivo e acesse Arquivo > Salvar como.
  2. No menu, nomeie seu arquivo e selecione CSV UTF-8 (delimitado por vírgula) (.csv) como formato do arquivo.
  3. Clique em Salvar.

excel_EN.png

Codificando um arquivo em UTF-8 com o Google Spreadsheet

Para salvar o arquivo .CSV como codificado UTF-8, você pode carregar o arquivo no Google Drive e facilmente armazená-lo como UTF-8. 

  1. Abra sua conta Google Drive.
  2. Clique no botão Novo no canto superior esquerdo.
  3. Clique em Carregar arquivo.
    Google_upload_EN.png
  4. Busque o arquivo .CSV e selecione-o.
  5. Abra o arquivo carregado com o Google Spreadsheet.
  6. Navegue por Arquivo > Baixar como, e selecione a opção Valores separados por vírgula (.csv, planilha atual).
    Google_CSV_EN.png

Codificando um arquivo em UTF-8 com o Bloco de notas

  1. Clique com o botão direito no arquivo que contenha seus contatos.
  2. Selecione Abrir com > Bloco de notas.
  3. Clique em Arquivo e selecione Salvar como.  
  4. Adicione a extensão .CSV para o nome do seu arquivo.
  5. Para Tipo, escolha Todos os arquivos.
  6. Para Codificação, escolha UTF-8
  7. Clique em Salvar.

Notepad_EN.png

Codificando um arquivo em UTF-8 com Libre Office

  1. Abra o LibreOffice e acesse Arquivos.
  2. Clique em Abrir e selecione o arquivo em seu computador.
  3. Acesse Arquivo > Salvar como.
  4. Digite o nome do arquivo em sua caixa de diálogo.
  5. A partir do menu suspenso Salvar como tipo, selecione Texto CSV (.csv).
  6. Marque a opção Editar configurações de filtro.
    Libre_Office_EN.png
  7. Clique em Salvar.
  8. Na caixa de diálogo Exportar arquivo de texto, selecione a opção Unicode (UTF-8) no menu suspenso Conjunto de caracteres.
  9. Configure os delimitadores de campo e de texto como desejar ou deixe como está.
    Export_text_file_window_EN.png
  10. Clique em OK.

Isso salvará o arquivo como codificado UTF-8 no Libre Office.

💡 Dica
Se seus dados de contato contiverem um caractere se substituição "�" UTF-8, ele será pulado e o valor de atributo correspondente não será armazenado em sua base de dados de contato. Este caractere pode ser introduzido na exportação de algumas ferramentas. Ele é usado para substituir um caractere desconhecido, não reconhecido ou não representável.

⏩ O que vem a seguir?