Neste artigo, vamos explicar como formatar seu arquivo de importação de contatos.
Quando você importa contatos para a Brevo, os dados de seu arquivo de importação serão vinculados a atributos de contato em sua conta Brevo. Alguns tipos de atributos de contato, como EMAIL e SMS, requerem um formato específico para serem importados corretamente.
Antes de começar
-
Existem 4 atributos padrão na Brevo 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 Quais são os diferentes tipos de atributos de contato?.
Tipos de arquivo
Os seguintes tipos de arquivo são compatíveis para importar seus contatos para a Brevo:
- .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.
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.
Atributos de contato
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.
Número de telefone fixo
Para importar o número de telefone de um contato para o qual deseja ligar, use o atributo padrão LANDLINE_NUMBER como cabeçalho da coluna. Sempre inclua o sinal + e o código do país para cada número de telefone. Não separe os dígitos por nenhum caractere especial.
SMS
Para importar o número de telefone de um contato para o qual deseja enviar mensagens de SMS, 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 de telefone e não separe os dígitos por nenhum caractere especial.
Para importar o número de telefone de um contato para o qual deseja enviar mensagens de WhatsApp, use o atributo padrão WhatsApp como cabeçalho da sua coluna. Sempre inclua o sinal + e o código do país para cada número de telefone e não separe os dígitos por nenhum caractere especial.
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.
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.
Booleano
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.
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"
Data
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.
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
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:
- Clique para baixar a amostra do arquivo de importação (delimitado por ponto e vírgula)
- Clique para baixar a amostra do arquivo de importação (delimitado por vírgula)
- Clique para baixar a amostra do arquivo de importação (delimitado por tab)
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 Brevo.
Tamanho do arquivo
O maior tamanho de arquivo que pode ser importado para sua conta Brevo é 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.
Codificando um arquivo em UTF-8 com o Microsoft Excel
- Abra seu arquivo e acesse Arquivo > Salvar como.
- No menu, nomeie seu arquivo e selecione CSV UTF-8 (delimitado por vírgula) (.csv) como formato do arquivo.
- Clique em Salvar.
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.
- Abra sua conta Google Drive.
- Clique no botão Novo no canto superior esquerdo.
- Clique em Carregar arquivo.
- Busque o arquivo .CSV e selecione-o.
- Abra o arquivo carregado com o Google Spreadsheet.
- Navegue por Arquivo > Baixar como, e selecione a opção Valores separados por vírgula (.csv, planilha atual).
Codificando um arquivo em UTF-8 com o Bloco de notas
- Clique com o botão direito no arquivo que contenha seus contatos.
- Selecione Abrir com > Bloco de notas.
- Clique em Arquivo e selecione Salvar como.
- Adicione a extensão .CSV para o nome do seu arquivo.
- Para Tipo, escolha Todos os arquivos.
- Para Codificação, escolha UTF-8.
- Clique em Salvar.
Codificando um arquivo em UTF-8 com Libre Office
- Abra o LibreOffice e acesse Arquivos.
- Clique em Abrir e selecione o arquivo em seu computador.
- Acesse Arquivo > Salvar como.
- Digite o nome do arquivo em sua caixa de diálogo.
- A partir do menu suspenso Salvar como tipo, selecione Texto CSV (.csv).
- Marque a opção Editar configurações de filtro.
- Clique em Salvar.
- Na caixa de diálogo Exportar arquivo de texto, selecione a opção Unicode (UTF-8) no menu suspenso Conjunto de caracteres.
- Configure os delimitadores de campo e de texto como desejar ou deixe como está.
- Clique em OK.
Isso salvará o arquivo como codificado UTF-8 no Libre Office.
⏩ O que vem a seguir?
🤔 Dúvidas?
Em caso de dúvida, sinta-se à vontade para entrar em contato com nossa equipe de suporte, criando um tíquete a partir da sua conta. Caso ainda não tenha uma conta, entre em contato conosco aqui.