Lorsque vous importez vos contacts dans Brevo, certaines données, telles que les adresses email et les numéros de téléphone, doivent être présentées dans un format spécifique pour être importées correctement. En suivant les exigences et les instructions fournies dans cet article, vous pouvez configurer correctement le fichier qui contient les informations de vos contacts.
À titre d’illustration, nous allons créer à partir de zéro un fichier .CSV, pour importer les contacts avec des attributs par défaut et personnalisés pour un professeur de yoga, que vous pouvez facilement adapter à vos besoins.
📂 Exigences en matière de fichiers
Votre fichier doit respecter les exigences suivantes :
- Le nombre de contacts que vous pouvez importer simultanément est illimité. Votre fichier ne doit toutefois pas dépasser 250 Mo. Si votre fichier dépasse cette limite, divisez-le en fichiers plus petits que vous importerez séparément.
- N'incluez qu'une seule feuille par fichier.
- Enregistrez votre fichier sous l'un des formats suivants et assurez-vous que le séparateur est un point-virgule, une virgule ou une tabulation :
.CSV |
.XLSX |
.TXT |
- Enregistrez votre fichier avec le codage UTF-8 ou Windows-1252. Ces types de codage permettent de lire le contenu de votre fichier lorsqu'il contient des caractères spéciaux.
- Pour créer un contact, vous devez remplir au moins l'un des champs suivants : EMAIL, SMS, WHATSAPP, LANDLINE_NUMBER, ou EXT_ID.
Étape 1 : créer votre fichier
Pour créer votre fichier :
- Ouvrez votre tableur (Excel, Google Sheets) pour créer un nouveau fichier.
- Pour commencer, choisissez l'une des méthodes suivantes :
- Téléchargez notre exemple de fichier .CSV.
- Exportez les contacts que vous avez déjà dans Brevo (Exporter vos contacts à partir de Brevo) ou dans une autre application.
- Créez votre fichier à partir de zéro.
Étape 2 : préparer la ligne d’en-tête de votre fichier
Vous pouvez créer de nouveaux attributs lors de l’étape d'association du processus d'importation ; vous n’avez pas forcément besoin de les créer au préalable.
Ajoutez les informations que vous souhaitez importer sur vos contacts dans la ligne d'en-tête de votre fichier.
Chaque cellule d'en-tête représente une information qui sera associée à un attribut du contact Brevo lors de l'importation. Nous vous recommandons d’utiliser le nom exact de l'attribut du contact dans votre ligne en-tête, car cela permet à notre système de les faire correspondre automatiquement, mais ce n’est pas obligatoire.
Dans notre exemple, nous avons ajouté des attributs par défaut comme EMAIL ou FIRSTNAME, mais aussi des attributs personnalisés concernant les cours de yoga (FIRST_CLASS, LEVEL, FREE_TRIAL).
Pour en savoir plus sur le format attendu pour chaque attribut du contact, consultez la section suivante.
Étape 3 : ajouter les informations de vos contacts au fichier
Vous pouvez maintenant entrer les informations de vos contacts dans le fichier :
- Copiez les données d’un autre programme ou d’un fichier exporté, ou
- saisissez-les directement dans le fichier.
Veillez à ce que chaque colonne contienne les informations correspondant à l'attribut de la ligne d'en-tête de votre fichier et à ce que chaque ligne contienne les informations relatives à un seul contact.
Les informations de votre fichier doivent suivre un format spécifique pour être importées correctement. Il existe des directives spécifiques pour les éléments suivants :
Attributs du contact par défaut
Par défaut, certains attributs du contact sont disponibles dans Brevo. Ils nécessitent un format spécifique pour être importés correctement. Développez les accordéons suivants pour en savoir plus sur le format attendu pour chaque attribut du contact :
L'attribut CONTACT_ID est automatiquement créé par Brevo lorsque vous importez vos contacts. Il s'agit d'un nombre fixe qui ne peut pas être modifié. Vous pouvez récupérer l'identifiant de vos contacts uniquement en les exportant à partir de Brevo.
Pour importer le prénom et le nom de famille de vos contacts, utilisez les attributs de contact FIRSTNAME et LASTNAME.
Pour importer l'adresse email de vos contacts, utilisez l'attribut du contact EMAIL.Chaque contact ne peut avoir qu’une seule adresse email et celle-ci doit être unique à ce contact.
N'incluez aucun caractère spécial.
Assurez-vous que les adresses email de votre fichier sont valides et qu’aucune partie n'est manquante.
Dans notre exemple erroné ci-dessous, l’adresse email ne comporte pas le suffixe du domaine et contient un caractère spécial :
❌ | rose&@exemple | ✅ | rose@exemple.com |
Pour importer le numéro de téléphone d'un contact, utilisez les attributs de contact par défaut suivants comme en-têtes de colonne :
- SMS pour le numéro de téléphone utilisé pour les SMS et les appels via l’application Phone.
- WHATSAPP pour le numéro de téléphone utilisé pour les messages WhatsApp et les appels via l’application Phone.
- LANDLINE_NUMBER pour le numéro de téléphone utilisé pour les appels via l'application Phone.
Ne séparez pas les chiffres en utilisant des caractères spéciaux.
Assurez-vous que les numéros de téléphone de votre fichier incluent le signe + et l’indicatif du pays et que les chiffres ne sont pas séparés par un caractère spécial.
Dans notre exemple erroné ci-dessous, il manque le signe +, et l'indicatif du pays dans le numéro de téléphone et les chiffres sont séparés par des caractères spéciaux :
❌ | (337) 456-9342 | ✅ | +13374569342 |
Pour importer l'identifiant externe d'un contact créé en dehors de Brevo, utilisez l'attribut de contact EXT_ID.
Attributs du contact personnalisés
Vous pouvez créer des attributs du contact personnalisés dans Brevo pour répondre à vos besoins. Pour être importés correctement, ils nécessitent un format spécifique, qui est basé sur le type d'attribut. Développez les accordéons suivants pour en savoir plus sur le format attendu pour chaque type d’attribut :
Les attributs de type texte stockent une chaîne de caractères alphanumériques, telle qu'un mot, une expression ou une phrase. Vous pouvez utiliser un attribut de type texte pour importer des données supplémentaires concernant vos contacts. Lorsqu'ils sont importés, les attributs de type texte n'ont pas de limite de caractères.
Les attributs de type numérique stockent une chaîne de chiffres ou des nombres écrits au format décimal. Vous pouvez utiliser un attribut de type numérique pour importer des nombres ou des valeurs monétaires dans vos contacts.
Les attributs de type date sont utilisés pour stocker une valeur de date. Le format de la valeur de cet attribut doit être similaire au format sélectionné dans les paramètres de votre compte (JJ-MM-AAAA ou MM-JJ-AAAA).
Les attributs de type catégorie stockent un ensemble de valeurs possibles. Vous pouvez par exemple créer un attribut de contact appelé LEVEL et définir les valeurs possibles comme DÉBUTANT, INTERMÉDIAIRE et EXPERT. L'attribut de chaque contact ne contiendra alors qu'une seule valeur parmi ces trois choix.
Les attributs de type choix multiple stockent un ensemble de valeurs possibles. Vous pouvez par exemple créer un attribut de contact appelé SPORTS et définir BASEBALL, FOOTBALL et YOGA comme valeurs possibles. L'attribut de chaque contact contiendra alors une ou plusieurs valeurs parmi ces trois choix.
Les attributs de contacts de type choix multiple doivent suivre le format : ['Option1'|'Option2'|'Option3'].
Assurez-vous que les attributs du contact de type choix multiple dans votre fichier respectent le format : ['Option1'|'Option2'|'Option3'].
Dans notre exemple erroné ci-dessous, les options sont séparées par une virgule au lieu d’une barre verticale et aucune option n'est entourée de guillemets simples.
❌ | [Baseball,Volleyball,Dance] | ✅ | ['Baseball'|'Volleyball'|'Dance'] |
Les attributs de type booléen ne peuvent stocker que la valeur Yes ou No.
Étape 4 : enregistrer votre fichier
Une fois que vous avez finalisé et correctement mis en forme votre fichier, enregistrez-le au format .CSV, .XLSX ou .TXT en utilisant le codage UTF-8 ou Windows-1252.
Utilisez les accordéons ci-dessous pour apprendre à encoder un fichier au format UTF-8 à l'aide de divers éditeurs de tableurs : ⬇️
- Ouvrez votre fichier dans Microsoft Excel.
- Cliquez sur Fichier > Enregistrer sous.
- Attribuez un nom à votre fichier.
- Sélectionnez CSV UTF-8 (délimité par des virgules) (.csv) comme format de fichier.
- Cliquez sur Enregistrer.
- Ouvrez votre fichier dans Google Spreadsheet.
- Cliquez sur Fichier > Télécharger.
- Sélectionnez le format de fichier Valeurs séparées par des virgules (.csv, feuille actuelle).
- Ouvrez votre fichier dans le Bloc-notes.
- Cliquez sur Fichier > Enregistrer sous.
- Attribuez un nom à votre fichier et ajoutez l'extension .csv à la fin.
- Dans le menu déroulant Type, sélectionnez Tous les fichiers.
- Dans le menu déroulant Codage, choisissez UTF-8.
- Cliquez sur Enregistrer.
- Ouvrez votre fichier dans LibreOffice.
- Cliquez sur Fichier > Enregistrer sous.
- Attribuez un nom à votre fichier.
- Dans le menu déroulant Type, sélectionnez Texte CSV (.csv).
- Activez l'option Éditer les paramètres du filtre.
- Cliquez sur Enregistrer.
- Dans la boîte de dialogue Exporter un fichier texte, sélectionnez l'option Unicode (UTF-8) dans le menu déroulant Jeu de caractères.
- Définissez le délimiteur de champ et le délimiteur de chaîne.
- Cliquez sur OK.
- Ouvrez votre fichier dans Numbers.
- Cliquez sur Fichier.
- Sélectionnez Exporter vers... > CSV....
- Cliquez sur Options avancées.
- Cliquez sur le menu déroulant Codage du texte.
- Sélectionnez Unicode (UTF-8).
- Cliquez sur Suivant.
- Attribuez un nom à votre fichier et choisissez un emplacement.
- Cliquez sur Enregistrer.
Étape 5 : importer votre fichier dans Brevo
Il est maintenant temps d'importer les données de vos contacts dans Brevo !
➡️ Pour savoir comment importer votre fichier dans Brevo, consultez notre article dédié Importer vos contacts dans Brevo.
❓ FAQ
Vous pouvez associer vos contacts à des opportunités et à des entreprises en ajoutant des champs spécifiques à votre fichier et en les important dans Brevo. Pour en savoir plus, consultez notre article dédié Associer mes entreprises, mes opportunités et mes contacts.
Si le signe « + » disparaît lorsque vous l'ajoutez à l'un des numéros de téléphone de votre fichier, ajoutez une apostrophe avant ce signe. Cela permettra à votre tableur de l'identifier comme étant un numéro de téléphone.
Oui, vous pouvez importer un fichier contenant des champs vides. Les résultats dépendent du type de contacts que vous importez et des options que vous activez lors de la finalisation de l'importation :
- Si vous importez de nouveaux contacts, les champs vides de votre fichier seront également vides dans Brevo.
- Si vous importez des contacts existants et si vous avez supprimé certaines de leurs données du fichier, il y a deux cas de figure :
- Si vous avez activé l'option Importer des champs vides pour effacer les données existantes des attributs lors de la finalisation de l'importation, les champs vides effaceront les données existantes dans Brevo.
- Si vous avez désactivé l'option Importer des champs vides pour effacer les données existantes des attributs lors de la finalisation de l'importation, les champs vides n'affecteront pas les données existantes.
Si vos données de contact contiennent le caractère de remplacement UTF-8 « � », elles seront ignorées et l'attribut de contact correspondant ne sera pas importé dans Brevo. Ce caractère peut apparaître lors de l'exportation de données à partir de certains outils car il est utilisé pour remplacer des caractères inconnus, non reconnus ou non représentables.
Le système ne prend pas en charge les fichiers Excel (.xls), ACT!, .vcf (Apple vCard) ou d’autres types de fichiers, vous devez donc convertir votre fichier dans l’un des formats pris en charge (.CSV, .XLSX ou .TXT).
Vous pouvez utiliser les outils en ligne gratuits pour convertir votre fichier. Avant de l'importer sur Brevo, assurez-vous que le fichier converti suit les recommandations concernant la configuration d'un fichier d'importation expliquées dans cet article.
⏭ Et après ?
- Importer vos contacts dans Brevo
- FAQ : pourquoi ne puis-je pas importer mes contacts ?
- À propos des attributs de contact
- Créer et gérer des attributs de contact personnalisés
🤔 Vous avez des questions ?
Pour toute question, n’hésitez pas à contacter notre service client en créant un ticket à partir de votre compte. Si vous n’avez pas encore de compte, vous pouvez nous contacter ici.
Si vous avez besoin d'aide pour un projet impliquant Brevo, nous pouvons vous mettre en relation avec une agence partenaire Brevo.
- CSV_sample.csv393 octets