Crie um arquivo para importar seus contatos

Ao importar os contatos para o Brevo, determinados dados, como endereços de e-mail e números de telefone, precisam estar em um formato específico para serem importados corretamente. Seguindo os requisitos e diretrizes fornecidos neste artigo, você pode configurar corretamente o arquivo que contém as informações do seu contato.

Para fins de ilustração, criaremos um arquivo .CSV do zero para importação de contatos com atributos padrão e personalizados para um instrutor de ioga que você pode facilmente adaptar às suas necessidades.

contacts_import_file_en-us.jpg

📂 Requisitos de arquivo

Seu arquivo deve seguir estes requisitos:

  • Não há limite para o número de contatos que você pode importar de uma vez. No entanto, o arquivo não deve exceder 250 MB. Se o arquivo exceder esse limite, divida-o em arquivos menores que serão importados separadamente.
  • Inclua apenas uma planilha no arquivo.
  • Salve o arquivo em um dos seguintes formatos e certifique-se de que o separador seja um ponto e vírgula, uma vírgula ou uma tabulação:

.CSV
(Microsoft Excel, OpenOffice Calc, Planilhas Google, Numbers)

.XLSX
(formato aberto do Microsoft Excel)

.TXT
(Bloco de notas da Microsoft)

  • Salve o arquivo com codificação UTF-8 ou Windows-1252. Esses tipos de codificação de arquivo permitem a leitura do conteúdo do arquivo quando ele contém caracteres especiais.
  • Pelo menos um dos campos a seguir é obrigatório para criar um contato: EMAIL, SMS, WHATSAPP, LANDLINE_NUMBER ou EXT_ID.

Etapa 1: crie seu arquivo

Para criar seu arquivo:

  1. Abra o programa de planilha (Excel, Planilhas Google) para criar um novo arquivo.
  2. Escolha uma das seguintes maneiras de começar:

Etapa 2: prepare a linha de cabeçalho do seu arquivo

💡 É bom saber

Você pode criar novos atributos durante a etapa de mapeamento do processo de importação; não precisa necessariamente criá-los antes.

Adicione as informações que deseja importar sobre seus contatos na linha cabeçalho do seu arquivo.

Cada célula de cabeçalho representa informações que serão associadas a um atributo de contato do Brevo durante a importação. Recomendamos usar os nomes exatos do atributo de contato na linha de cabeçalho, pois isso ajuda nosso sistema a associá-los automaticamente, mas não é obrigatório.

➡️  Por exemplo

No exemplo, adicionamos atributos padrão como EMAIL ou FIRSTNAME, mas também incluímos atributos personalizados sobre as aulas de ioga (FIRST_CLASS, LEVEL, FREE_TRIAL).contacts_header_row_en-us.jpg

Para saber mais sobre o formato esperado para cada atributo de contato, verifique a próxima seção.

Etapa 2: adicione as informações dos contatos ao arquivo

Agora você pode inserir as informações dos seus contatos no arquivo:

  • Copie os dados de outro programa ou de um arquivo exportado, ou
  • Digite-os diretamente no arquivo.

Faça com que cada coluna contenha informações que correspondam ao atributo na linha de cabeçalho do arquivo e que cada linha contenha informações sobre um único contato.

As informações no arquivo devem seguir um formato específico para serem importadas corretamente. Existem diretrizes específicas para:

Atributos de contato padrão

Por padrão, alguns atributos de contato estão disponíveis no Brevo. Eles exigem um formato específico para serem importados corretamente. Expanda os itens a seguir para saber mais sobre o formato esperado para cada atributo de contato:

🆔 CONTACT_ID

O atributo CONTACT_ID é criado automaticamente pela Brevo quando você importa seus contatos. É um número fixo que não pode ser alterado. Você só pode recuperar o ID dos contatos exportando-os do Brevo.

❗️ Importante
Recomendamos incluir o atributo CONTACT_ID no arquivo somente se desejar atualizar os contatos existentes por meio de uma importação. Se você estiver importando novos contatos, exclua a coluna CONTACT_ID.

contacts_contactID_en-us.jpg

👤 FIRSTNAME/LASTNAME

Para importar o nome e o sobrenome dos contatos, use os atributos de contato FIRSTNAME e LASTNAME.

contacts_name_en-us.jpg

✉️ EMAIL

Para importar o endereço de e-mail dos contatos, use o atributo de contato EMAIL.
Cada contato pode ter apenas um endereço de e-mail, e ele deve ser exclusivo para aquele contato.

Não inclua nenhum caractere especial.

contacts_email_en-us.jpg

❗️ Importante
O atributo de contato EMAIL não suporta caracteres especiais, mesmo com codificação UTF-8 ou Windows-1252.

Os endereços de e-mail no seu arquivo devem ser válidos e não deve faltar nenhuma parte.
No exemplo errado abaixo, o endereço de e-mail não tem o sufixo do domínio e contém um caractere especial:

rosa&@exemplo rosa@exemplo.com
📱 SMS / WHATSAPP / LANDLINE_NUMBER
💡 É bom saber
Um contato pode ter o mesmo número de telefone para SMS, WhatsApp e um número de telefone fixo. Listas de bloqueio separadas são usadas quando um contato cancela a assinatura de SMS, WhatsApp ou Phone.

Para importar o número de telefone de um contato, use os seguintes atributos de contato padrão como cabeçalhos de coluna:

  • SMS para o número de telefone usado para mensagens SMS e chamadas pelo aplicativo Phone.
  • WHATSAPP para o número de telefone usado para mensagens do WhatsApp e chamadas pelo aplicativo Phone.
  • LANDLINE_NUMBER para o número de telefone usado para chamadas por meio do app Phone.

Não separe os dígitos com nenhum caractere especial.

❗️ Importante
Se você estiver importando números com códigos de países diferentes, sempre inclua uma aspa simples ('), o sinal de mais (+) e o código do país no início do número de telefone. Se o sinal de mais estiver ausente, a Brevo aplicará o código de país padrão durante o mapeamento, o que pode resultar em números incorretos. As aspas simples garantem que o sinal + seja mantido no seu arquivo, evitando que o código do país seja substituído quando um padrão é aplicado.

contacts_phone_en-us.jpg

Os números de telefone no arquivo devem incluir o sinal + e o código do país e os dígitos não devem estar separados por nenhum caractere especial.
No exemplo errado abaixo, falta o sinal + e o código do país no número de telefone, e os dígitos são separados por caracteres especiais:

(337) 456-9342 +13374569342
👽 EXT_ID

Para importar o ID externo de um contato criado fora do Brevo, use o atributo de contato EXT_ID.

contacts_ext-id-attribute-example_EN-US.png

Atributos de contato personalizados

Você pode criar atributos de contato personalizados na Brevo para satisfazer suas necessidades. Eles exigem um formato específico para serem importados corretamente, baseado no tipo de atributo. Expanda os itens a seguir para saber mais sobre o formato esperado para cada tipo de atributo:

🔠 TEXTO

Os atributos do tipo de texto armazenam uma string de caracteres alfanuméricos, como uma palavra, frase ou sentença. Você pode usar um atributo de tipo de texto para importar dados adicionais sobre os contatos. Quando importados, os atributos de tipo de texto não têm limite de caracteres.

contacts_city_en-us.jpg

🔢 NÚMERO

Os atributos do tipo de número armazenam uma string de numerais ou números escritos em formato decimal. Você pode usar um atributo de tipo de número para importar números ou valores monetários para seus contatos.

📆 DATE (DATA)

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

contacts_firstclass_en-us.jpg

💡 É bom saber
Hífens - e barras / são intercambiáveis. Por exemplo, 13-03-2022 e 13/03/2022 são considerados iguais.
🗂️ CATEGORIA

Os atributos do tipo de categoria armazenam um conjunto de valores possíveis. Por exemplo, você pode criar um atributo de contato denominado LEVEL e definir os valores possíveis como BEGINNER, INTERMEDIATE e EXPERT. O atributo de cada contato conterá apenas um valor entre esses três.

contacts_import_category-attribute_en-us.jpg

💡 É bom saber
Você também tem a opção de incluir o número de identificação do valor, em vez do valor em si. Você pode visualizar o número de ID de um valor clicando no ícone de engrenagem ⚙️ próximo ao atributo de contato desejado na página Contact Attributes (Atributos de contato).
✖️ MÚLTIPLA ESCOLHA

Os atributos do tipo múltipla escolha armazenam um conjunto de valores possíveis. Por exemplo, você pode criar um atributo de contato chamado SPORTS e definir os valores possíveis como BASEBALL, FOOTBALL e YOGA. O atributo de cada contato terá um ou mais valores entre esses três.

Os atributos de contato do tipo múltipla escolha devem seguir o formato: ['Opção1'|'Opção2'|'Opção3'].

contacts_multi-choice-attribute_EN-US.png

Certifique-se de que o atributo de contato do tipo múltipla escolha no arquivo siga o formato: ['Opção1'|'Opção2'|'Opção3'].
No exemplo errado abaixo, as opções estão separadas por uma vírgula em vez de uma barra vertical, e cada opção não tem as aspas simples.

[Baseball,Volleyball,Dance] ['Baseball'|'Volleyball'|'Dance']
👍👎 BOOLEANO

Os atributos do tipo booleano só podem armazenar Sim ou Não como valor. 

Etapa 4: salve o arquivo

Depois de concluir e formatar corretamente o arquivo, salve-o no formato .CSV, .XLSX ou .TXT usando a codificação UTF-8 ou Windows-1252.

Use as dicas abaixo para aprender como codificar um arquivo em UTF-8 usando vários editores de planilhas: ⬇️

Microsoft Excel
  1. Abra o arquivo no Microsoft Excel.
  2. Clique em File > Save As (Arquivo > Salvar como).
  3. Dê um nome ao seu arquivo.
  4. Selecione CSV UTF-8 (delimitado por vírgula) (.csv) como formato de arquivo.
    excel_EN.png
  5. Clique em Save (Salvar).
📗 Planilhas Google
  1. Abra o arquivo em Planilhas Google.
  2. Clique em File> Download (Arquivo > Baixar).
  3. Selecione Valores separados por vírgula (.csv, planilha atual) como formato de arquivo.
    utf8_googlespreadsheet.jpg
🗒️ Bloco de Notas
  1. Abra o arquivo no Bloco de Notas.
  2. Clique em File > Save as (Arquivo > Salvar como).
  3. Escolha um nome para o arquivo e adicione a extensão .csv no final.
  4. No menu suspenso Save as type (Salvar como tipo), selecione All files (Todos os arquivos).
  5. No menu suspenso Encoding (Codificação), escolha UTF-8.
    utf8_notepad.jpg
  6. Clique em Save (Salvar).
📄 LibreOffice
  1. Abra o arquivo no LibreOffice.
  2. Clique em File > Save as (Arquivo > Salvar como).
  3. Dê um nome ao seu arquivo.
  4. No menu suspenso Save as type (Salvar como tipo), selecione Text CSV (.csv) (Texto CSV (.csv)).
  5. Ative a opção Edit filter settings (Editar configurações de filtro).
    utf8_libreoffice.png
  6. Clique em Save (Salvar).
  7. Na caixa de diálogo Export Text File (Exportar arquivo de texto), selecione a opção Unicode (UTF-8) no menu suspenso Conjunto de caracteres.
  8. Defina o Field delimiter (Delimitador de campo) e o String delimiter (Delimitador de string).
  9. Clique em OK.
📊 Numbers
  1. Abra o arquivo no Numbers (Números).
  2. Clique em File (Arquivo).
  3. Selecione Export to... > CSV... (Exportar para... > CSV...)
    utf8_numbers.jpg
  4. Clique em Advanced options (Opções avançadas).
  5. Clique no menu suspenso Text Encoding (Codificação de texto).
  6. Selecione Unicode (UTF-8).
    utf8_numbers2.jpg
  7. Clique em Next (Próximo).
  8. Dê um nome ao arquivo e escolha um local.
  9. Clique em Save (Salvar).

Etapa 5: importe o arquivo para a Brevo

Agora é hora de importar os dados dos contatos para a Brevo!

➡️ Para saber como importar seu arquivo para o Brevo, confira nosso artigo dedicado Importe seus contatos para o Brevo.

FAQ

🤝 Posso associar meus contatos a oportunidades e empresas?

Você pode associar seus contatos a oportunidades e empresas adicionando campos específicos ao arquivo e importando-o para a Brevo. Para saber mais, consulte o artigo dedicado Associe suas empresas, oportunidades e contatos..

📱 O sinal "+" para números de telefone desaparece quando eu o adiciono ao arquivo. Como posso impedir isso?

Se o sinal "+" desaparecer quando você adicioná-lo a um número de telefone no arquivo, adicione um apóstrofo antes dele. Isso ajudará o programa de planilha a reconhecer o número como um número de telefone.

🗒️ Posso importar um arquivo que contenha campos vazios?

Sim, você pode importar um arquivo que contenha campos vazios. Os resultados dependerão do tipo de contatos que você está importando e das opções ativadas ao finalizar a importação:

Meu arquivo contém o caractere de substituição UTF-8 "�". O que acontecerá quando eu fizer o upload?

Se os dados de contato contiverem o caractere de substituição UTF-8 "�", eles serão ignorados e o atributo de contato correspondente não será importado para a Brevo. Esse caractere pode aparecer ao exportar dados de determinadas ferramentas, pois é usado para substituir caracteres desconhecidos, não reconhecidos ou não representáveis.

💾 Não consigo salvar meu arquivo no formato .CSV, .XLSX ou .TXT

O sistema não é compatível com Excel (.xls), ACT!, .vcf (Apple vCard) ou outros tipos de arquivo, então você precisa converter seu arquivo em um dos formatos compatíveis (.CSV, .XLSX ou .TXT).

Você pode usar ferramentas online gratuitas para converter seu arquivo. Antes de fazer upload para o Brevo, verifique se o arquivo convertido segue as recomendações de configuração de um arquivo de importação explicadas neste artigo.

⏭️ 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.

Se você está procurando ajuda com um projeto usando o Brevo, podemos encontrar à agência parceira da Brevo certa.

💬 Este artigo foi útil?

Utilizadores que acharam útil: 114 de 214