Ao importar os contatos para a 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. Portanto, antes de importar os contatos, recomendamos seguir este artigo para configurar corretamente o arquivo que contém as informações de seus contatos.
📂 Requisitos de arquivo
- 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 |
.XLSX |
.TXT |
- 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.
🛠️ Crie o arquivo
Neste artigo, para fins ilustrativos, criaremos um arquivo .CSV do zero para importar contatos com atributos padrão e personalizados para um instrutor de ioga. Você pode adaptar facilmente esse caso de uso às suas necessidades seguindo os requisitos e diretrizes fornecidos neste artigo.
Etapa 1: configure o arquivo com atributos de contato
- Abra o programa de planilha (Excel, Planilhas Google) para criar um novo arquivo. Você tem 3 opções para começar:
- Você pode baixar nosso arquivo .CSV de amostra.
- Você pode exportar os contatos que já possui na Brevo (Exportar seus contatos da Brevo) ou em outro app.
- Você pode começar do zero.
- Na linha de cabeçalho do arquivo, adicione as informações que deseja importar sobre seus contatos. Cada célula representa uma informação que será mapeada para um atributo de contato da Brevo e importada.
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).
Use as guias abaixo para entender mais sobre todos os atributos de contato disponíveis ⬇️
Por padrão, alguns atributos de contato são criados automaticamente pela Brevo. Eles exigem um formato específico para serem importados corretamente:
🆔 CONTACT_IDO 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 a ID dos contatos exportando-os da Brevo. Recomendamos incluir o atributo CONTACT_ID no arquivo somente se desejar atualizar os contatos existentes por meio de uma importação.
👤 FIRSTNAME/LASTNAMEPara importar o nome e o sobrenome dos contatos, use os atributos de contato FIRSTNAME e LASTNAME.
✉️ EMAILPara importar o endereço de e-mail dos contatos, use o atributo de contato EMAIL.
📱 SMS / WHATSAPP / LANDLINE_NUMBER💡 É bom saberOs contatos podem ter o mesmo número de telefone para SMS, WhatsApp e Phone. 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.
- WHATSAPP para o número de telefone usado para mensagens do WhatsApp.
- LANDLINE_NUMBER para o número de telefone usado para chamadas por meio do app Phone.
Sempre inclua o sinal + e o código do país no início do número de telefone e não separe os dígitos com nenhum caractere especial.
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:
🔠 TEXTOOs 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.
🔢 NÚMEROOs 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.
🔢 DATAAtributos 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).
💡 É bom saberHífens - e barras / são intercambiáveis. Por exemplo, 13-03-2022 e 13/03/2022 são considerados iguais.🗂️ CATEGORIAOs 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.
💡 É bom saberVocê 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 ESCOLHAOs 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'].
💡 É bom saberVocê 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) .👍👎 BOOLEANOOs atributos do tipo booleano só podem armazenar Sim ou Não como valor.
Ao importar o arquivo na Brevo, você poderá criar novos atributos diretamente. Você não precisa necessariamente criá-los de antemão.
Etapa 2: adicione as informações dos contatos ao arquivo
Agora, você pode preencher o arquivo com as informações dos contatos:
- Você pode copiar os dados de outro programa ou arquivo exportado, ou
- Você pode digitá-los 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:
Etapa 3: verifique o formato dos dados
Agora que o arquivo contém todos os dados que você deseja importar, reserve um tempo para garantir que ele esteja formatado corretamente. Dados formatados incorretamente podem resultar na importação de informações incorretas ou na não importação de informações.
Por exemplo, aqui estão algumas coisas que recomendamos que você verifique:
-
O endereço de e-mail dos contatos: certifique-se de que os endereços de e-mail do arquivo sejam válidos e que não falte nenhuma parte.
No exemplo errado abaixo, o endereço de e-mail não contém o sufixo de domínio:
❌ rosa@exemplo ✅ rosa@exemplo.com -
O número de telefone dos contatos: certifique-se de que os números de telefone do arquivo incluam o sinal + e o código do país e que os dígitos não estejam 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 -
Atributos de contato do tipo múltipla escolha: certifique-se de que os atributos de contato do tipo múltipla escolha em seu arquivo siga o formato: ['Opção1'|'Opção2'|'Opção3'].
Em nosso 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']
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 ⬇️
- Abra o arquivo no Microsoft Excel.
- Clique em File > Save As (Arquivo > Salvar como).
- Dê um nome ao seu arquivo.
- Selecione CSV UTF-8 (delimitado por vírgula) (.csv) como formato de arquivo.
- Clique em Save (Salvar).
- Abra o arquivo em Planilhas Google.
- Clique em File> Download (Arquivo > Baixar).
- Selecione Valores separados por vírgula (.csv, planilha atual) como formato de arquivo.
- Abra o arquivo no Bloco de Notas.
- Clique em File > Save as (Arquivo > Salvar como).
- Escolha um nome para o arquivo e adicione a extensão .csv no final.
- No menu suspenso Save as type (Salvar como tipo), selecione All files (Todos os arquivos).
- No menu suspenso Encoding (Codificação), escolha UTF-8.
- Clique em Save (Salvar).
- Abra o arquivo no LibreOffice.
- Clique em File > Save as (Arquivo > Salvar como).
- Dê um nome ao seu arquivo.
- No menu suspenso Save as type (Salvar como tipo), selecione Text CSV (.csv) (Texto CSV (.csv)).
- Ative a opção Edit filter settings (Editar configurações de filtro).
- Clique em Save (Salvar).
- 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.
- Defina o Field delimiter (Delimitador de campo) e o String delimiter (Delimitador de string).
- Clique em OK.
- Abra o arquivo no Numbers (Números).
- Clique em File (Arquivo).
- Selecione Export to... > CSV... (Exportar para... > CSV...)
- Clique em Advanced options (Opções avançadas).
- Clique no menu suspenso Text Encoding (Codificação de texto).
- Selecione Unicode (UTF-8).
- Clique em Next (Próximo).
- Dê um nome ao arquivo e escolha um local.
- Clique em Save (Salvar).
Etapa 5: importe o arquivo para a Brevo
Agora é hora de importar os dados dos contatos para a Brevo! Você encontrará todos os detalhes no artigo dedicado Importe seus contatos para a Brevo.
❓ FAQ
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..
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.
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:
- Se você estiver importando novos contatos, os campos vazios do arquivo também estarão vazios na Brevo.
- Se você estiver importando contatos existentes e removeu alguns dados do arquivo, há dois casos:
- Se você ativou a opção Import empty fields to erase existing attribute data (Importar campos vazios para apagar dados de atributos existentes ao finalizar a importação, os campos vazios apagarão os dados existentes na Brevo.
- Se você desativou a opção Import empty fields to erase existing attribute data (Importar campos vazios para apagar dados de atributos existentes) ao finalizar a importação, os campos vazios não afetarão os dados existentes.
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.
⏭️ 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 o parceiro especialista certificado em Brevo.
- CSV_sample.csv342 bytes