Comment inscrire automatiquement mes contacts dans mes listes Brevo ?

Poser un tag sur un contact ou un tiers l'inscrit dans vos listes Brevo. Retirer le tag le désinscrit. Plus d'export ni d'import.

Dolibarr · listes Brevo
01 / 08
Procédure pas à pas

Un tag
dans Dolibarr,
une liste
Brevo.

Poser un tag sur un contact ou un tiers l’inscrit dans vos listes Brevo. Retirer le tag le désinscrit. Plus d’export ni d’import.

ÉditionOctobre 2026
AudienceAdministrateurs et équipes marketing
VersionsDolibarr 19 à 24
02 / 08
Le parcours

Mise en place.

Un administrateur relie une fois chaque tag à ses listes Brevo. Ensuite, chacun pose et retire les tags comme d’habitude : Brevo suit tout seul.

  1. Avant de commencer : trois conditions1 min
  2. Mise en place : la clé, puis les tags~5 min
  3. Au quotidien : poser et retirer un tag1 min
  4. En cas de problème4 cas
03 / 08
Avant de commencer

Trois conditions, une seule fois.

Les deux premières se règlent dans Dolibarr, la troisième dans votre compte Brevo.

Condition
Ce qu’il faut
Qui s’en occupe
Module activé
Le module Connecteur Brévo est activé dans Accueil → Configuration → Modules, avec le module Tags/Catégories.
Administrateur
Clé d’API Brevo
Une clé d’API déjà créée dans votre compte Brevo. C’est la clé qui commence par « xkeysib- ».
Administrateur
Listes créées
Les listes de contacts existent déjà dans Brevo, menu Contacts → Listes. Dolibarr ne les crée pas : il les propose telles quelles.
Équipe marketing
Versions

Captures faites sur Dolibarr 24, avec des données fictives

Le module Connecteur Brévo fonctionne de la version 19 à la 24 de Dolibarr. Les captures montrent sa version 1.4.

Le module envoie à Brevo l’adresse e-mail, et le nom quand il crée l’adresse dans Brevo. Une désinscription faite dans Brevo ne revient pas dans Dolibarr.

Mise en place 04 / 08
Étapes 1 et 2

Coller la clé, relier un tag à une liste.

  1. Configuration du module
    Coller la clé d’API

    Dans Accueil → Configuration → Modules, ouvrez la configuration du module Connecteur Brévo. Collez la clé dans Clé API Brévo, puis cliquez sur Enregistrer. Seul un administrateur de Dolibarr accède à cette page.

    Champ Clé API Brévo de la configuration du module, entouré en rouge
    Fig. 02 — Clé d’API Brevo
  2. Fiche du tag
    Choisir les listes du tag

    Ouvrez le tag. Le chemin dépend de votre version de Dolibarr :

    • Dolibarr 19 à 21 : menu Tiers, puis à gauche Tags/catégories de contacts, Tags/catégories clients/prosp. ou Tags/catégories fournisseurs.
    • Dolibarr 22 à 24 : menu Outils → Tags/catégories, puis la ligne Contacts, Prospects ou clients ou Fournisseurs.

    Cliquez sur le tag, puis sur Modifier. Cliquez dans Liste de destinataire associée : Dolibarr affiche les listes de votre compte Brevo. Choisissez-en une ou plusieurs.

    Listes Brevo proposées sous le champ Liste de destinataire associée : Newsletter clients, Prospects salon, Fournisseurs partenaires, entourées en rouge
    Fig. 03 — Les listes du compte Brevo

    Une liste que vous venez de créer dans Brevo n’apparaît pas ? Rechargez la page. Cliquez ensuite sur Enregistrer.

    Champ Liste de destinataire associée rempli avec Newsletter clients, entouré en rouge, au-dessus du bouton Enregistrer
    Fig. 04 — Liste choisie

Contacts ou tiers seulement. Le champ n’apparaît que sur les tags de contacts, et sur les tags de tiers : clients/prospects ou fournisseurs. Sur un tag de contacts, c’est l’e-mail du contact qui part ; sur un tag de tiers, l’e-mail du tiers.

Au quotidien 05 / 08
Étapes 3 et 4

Poser le tag inscrit, le retirer désinscrit.

  1. Fiche du contact ou du tiers
    Poser le tag

    Modifiez la fiche, ajoutez le tag, puis enregistrez. Sur un contact, le champ s’appelle Tags/catégories. Sur un tiers, c’est Tags/catégories clients ou Tags/catégories fournisseurs.

    Champ Tags/catégories de la fiche contact avec le tag Newsletter, entouré en rouge
    Fig. 05 — Tag posé sur le contact

    Si l’adresse n’existe pas encore dans Brevo, Dolibarr la crée, puis l’ajoute aux listes du tag. Un message vert le confirme en haut de l’écran ; pour un tiers, il dit « Ajout du tiers à la liste Brévo ».

    Message : Ajout du contact a la liste Brevo
    Fig. 06 — Contact inscrit
  2. Fiche du contact ou du tiers
    Retirer le tag

    Retirez le tag de la fiche (petite croix), puis enregistrez. L’adresse quitte les listes du tag ; elle reste dans les contacts de votre compte Brevo.

    Message : Le contact a été retiré des listes de contact Brévo associés à la catégorie retirée
    Fig. 07 — Contact désinscrit
Au quotidien 06 / 08
Bon à savoir

Ce qui se passe dans les autres cas.

En masse

Inscrire plusieurs fiches d’un coup

Dans la liste des contacts ou des tiers, cochez les fiches, puis choisissez l’action Affecter un tag/catégorie. Chaque fiche est inscrite comme si vous aviez posé le tag à la main.

Changement de listes

Modifier les listes d’un tag qui a déjà des membres

Les membres du tag quittent les listes retirées et rejoignent les listes ajoutées. Vider le champ les retire de toutes. Supprimer le tag les retire aussi de ses listes. Un message donne le nombre de membres traités.

Premier branchement : les membres déjà présents ne partent pas. Si vous reliez une liste à un tag qui a déjà des membres, ils ne sont pas envoyés à Brevo. Pour les envoyer, retirez puis reposez le tag sur chaque fiche. L’action en masse ne les envoie pas : elle ignore les fiches qui ont déjà le tag.

07 / 08
Avant d’ouvrir un ticket

En cas de problème.

LISTE VIDE
Aucune liste proposée, ou pas de message vert après la pose d’un tag

Pourquoi : Brevo refuse de répondre, et rien n’est parti. La clé d’API est fausse, ou Brevo bloque l’adresse IP de votre serveur Dolibarr.

Que faire : sur la fiche du tag, cliquez sur Annuler, pas sur Enregistrer : sinon le tag perd ses listes Brevo. Vérifiez la clé dans la configuration du module. Puis autorisez l’adresse du serveur dans votre compte Brevo, page des adresses IP autorisées.

PAS D’E-MAIL
« … car le contact ne dispose pas d’email »

Pourquoi : la fiche n’a pas d’adresse e-mail : il n’y a rien à envoyer à Brevo.

Que faire : renseigner l’e-mail sur la fiche, puis retirer et reposer le tag.

PAS DE RÉPONSE
« Brévo n’a pas répondu si ce destinataire existe déjà »

Pourquoi : Brevo était injoignable ou a répondu une erreur. Par prudence, rien n’a été envoyé.

Que faire : réessayer un peu plus tard. Si le message revient, transmettre l’heure de l’erreur à votre administrateur.

TROP DE MEMBRES
« … n’ont PAS été resynchronisés » ou suppression refusée

Pourquoi : le tag compte plus de 1 000 membres. Au-delà, Dolibarr ne déplace pas les membres et refuse de supprimer le tag, pour ne pas laisser d’inscrits introuvables.

Que faire : demander à votre administrateur de relever la limite (constante BREVOCONNECTOR_MAX_RESYNC_MEMBERS), ou traiter les membres depuis Brevo.

08 / 08
Fin du document

Un tag posé,
un contact inscrit,
sans export.

Reliez une fois chaque tag à ses listes Brevo. Ensuite, poser ou retirer le tag suffit : Dolibarr tient vos listes à jour et vous dit ce qu’il a fait.

Captures : Dolibarr 24.0.2, module Connecteur Brévo 1.4, données fictives
Module disponible de la version 19 à la 24
Dernière revue : octobre 2026