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.
📂 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 |
.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.
- 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:
- Abra o programa de planilha (Excel, Planilhas Google) para criar um novo arquivo.
- Escolha uma das seguintes maneiras de começar:
- Baixe nosso arquivo .CSV de exemplo.
- Exporte os contatos que você já tem no Brevo (Exportar contatos do Brevo) ou em outro aplicativo.
- Comece do zero.
Etapa 2: prepare a linha de cabeçalho do seu arquivo
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.
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).
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:
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.
Para importar o nome e o sobrenome dos contatos, use os atributos de contato FIRSTNAME e LASTNAME.
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.
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 |
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.
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 |
Para importar o ID externo de um contato criado fora do Brevo, use o atributo de contato EXT_ID.
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:
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.
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.
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).
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.
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'].
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'] |
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: ⬇️
- 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!
➡️ Para saber como importar seu arquivo para o Brevo, confira nosso artigo dedicado Importe seus contatos para o 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 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?
- Importe seus contatos para a Brevo
- Solução de problemas - Por que não consigo importar contatos?
- Sobre atributos de contato
- Criar e gerenciar atributos de contato personalizados
🤔 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.
- CSV_sample.csv393 bytes