BrevoSync - synchronisation bidirectionnelle et retours de délivrabilité

BrevoSync synchronise vos contacts et tiers Dolibarr vers Brevo à partir des catégories Dolibarr, puis réinjecte dans Dolibarr les retours d'envoi de Brevo. Dolibarr reste maître des données commerciales, Brevo reste maître des campagnes et de la délivrabilité.

Ce qui part de Dolibarr vers Brevo

• Contacts et tiers, avec l'adresse e-mail comme pivot et des règles de dédoublonnage déterministes documentées.
• Correspondance des attributs configurable (prénom, nom, société, téléphone) vers les attributs de votre propre compte Brevo, rechargés directement depuis l'API.
• Correspondance catégorie Dolibarr vers liste Brevo : seules les listes déclarées dans le tableau de correspondance sont pilotées, une liste créée à la main dans Brevo n'est jamais modifiée.
• Périmètre de synchronisation limitable aux membres des catégories associées, pour ne jamais créer chez Brevo une adresse qu'aucune correspondance ne désigne.
• Synchronisation immédiate d'une catégorie entière sur un simple bouton, resynchronisation complète forcée, et purge des lignes traitées.

Ce qui revient de Brevo dans Dolibarr

• Rebonds définitifs (hard bounce), plaintes pour spam et désabonnements, reçus par webhook signé au moyen d'un secret partagé.
• Alerte visible directement sur la fiche tiers et sur la fiche contact concernée, pour que le commercial sache immédiatement qu'une adresse ne reçoit plus rien.
• Désabonnement propre : le désabonnement remonté par Brevo est inscrit dans Dolibarr, ou réduit à une simple alerte visuelle si vous le préférez.
• Compteurs et agrégats par type de retour, avec durée de conservation des retours détaillés paramétrable.

Principes de conception

• Une file d'attente, pas un balayage. Un trigger dépose les adresses concernées dans une file ; deux tâches planifiées la dépilent. Aucune synchronisation n'est déclenchée par l'affichage d'une page et la base n'est jamais parcourue intégralement.
• Le désabonnement l'emporte toujours. Le module ne transmet jamais de réinscription implicite : un contact désabonné n'est jamais remis silencieusement dans une liste.
• Rien n'est déclaré synchronisé sans preuve. Chaque ligne de file porte un jeton de verrouillage, un compteur de tentatives, la dernière erreur et un rejeu ; elle ne passe à l'état terminé que sur réponse positive de l'API.
• Aucun fichier du cœur n'est modifié. Le module s'installe dans htdocs/custom et se désactive sans laisser de trace fonctionnelle.

Installation et configuration

• Installation par le gestionnaire de modules de Dolibarr, puis saisie de la clé API Brevo v3, qui est chiffrée avant enregistrement et n'est jamais réaffichée.
• Quatre écrans d'administration : paramètres, correspondances catégories / listes, file de synchronisation, retours d'envoi.
• Trois permissions distinctes : configurer, synchroniser, consulter.
• Deux tâches planifiées fournies et un point d'entrée webhook à déclarer dans Brevo.
• Prérequis : un compte Brevo avec une clé API v3. L'offre gratuite de Brevo suffit pour démarrer.

Compatibilité

• Version Dolibarr minimale : 21.0.0 — version Dolibarr maximale : 24.0.0. Développé et testé sur 23.0.3.
• PHP 7.4 à 8.4, MariaDB ou MySQL.
• Version du module : 2.1.0.

Licence, auteur et support

• Licence GPL v3 ou ultérieure, texte intégral fourni dans le fichier COPYING du paquet. Copyright (C) 2026 Thermasse.
• Auteur et éditeur : Thermasse (France).
• Support par courriel à support@thermasse.fr, en français et en anglais, réponse annoncée sous 2 jours ouvrés.
• Un an de mises à jour et de correction des anomalies à compter de l'achat. L'installation, la formation, les développements spécifiques et le support du compte Brevo ne sont pas inclus.
• Périmètre détaillé du support : https://www.thermasse.fr/modules/brevosync/support/

Brevo et Dolibarr sont des marques de leurs propriétaires respectifs. BrevoSync est un module d'interfaçage indépendant.

Nouveautés de la version 2.1.1

Version de sécurité et de fiabilité, issue d'un audit de code puis d'une recette indépendante. Aucune nouvelle fonctionnalité.

• Résilience renforcée de la résolution des contacts : une panne partielle de la base ne peut plus conduire à traiter un lot sur des données incomplètes.
• Protection CSRF sur toutes les pages d'administration.
• Accès HTTP restreint aux seules pages d'administration et au webhook : scripts, SQL, documentation et fichiers de langue ne sont plus téléchargeables.
• Réglages du module conservés lors d'une désactivation puis réactivation.
• Scripts de migration rendus rejouables et transactionnels.
• Secret du webhook chiffré au repos.

À noter : l'acquittement d'une alerte de délivrabilité relève désormais du droit « Déclencher une synchronisation Brevo » et non plus du droit de consultation. Il faut l'attribuer aux utilisateurs chargés de traiter les alertes.