EN BREF
✅ Les webhooks Brevo permettent de déclencher des actions en temps réel dans vos applications (ouverture email → CRM, clic → scoring)
✅ L’API Brevo supporte l’envoi d’événements personnalisés pour déclencher des automations depuis n’importe quelle application
⚠️ Les webhooks nécessitent un serveur capable de recevoir des requêtes HTTP POST — prévoir l’infrastructure
[CTA:brevo]
Brevo webhooks et API events : connecter Brevo à votre stack
Brevo webhooks api events configuration est au cœur de cet article. Brevo webhooks api events configuration est au cœur de cet article. Brevo webhooks api events configuration est au cœur de cet article. Brevo ne doit pas rester isolé dans votre infrastructure. Les webhooks sortants et l’API d’événements entrants créent un pont bidirectionnel entre Brevo et vos applications. Ce guide s’adresse aux développeurs et intégrateurs qui veulent exploiter ces fonctionnalités.
[IMAGE:diagramme d’architecture technique avec flux de données entre applications et serveurs sans personnes]
Les webhooks Brevo : Brevo → votre app
Principe :
Quand un événement se produit dans Brevo (email ouvert, lien cliqué, désinscription, bounce), Brevo envoie une requête HTTP POST vers votre URL configurée avec les données de l’événement.
Événements disponibles :
email.opened: email ouvertemail.clicked: lien cliqué (avec l’URL cliquée)email.delivered: email délivréemail.hardbounce: bounce définitifemail.softbounce: bounce temporaireemail.spam: marqué comme spamemail.unsubscribe: désabonnementcontact.created: nouveau contactcontact.updated: contact mis à jour
Configuration :
- Brevo → Settings → Webhooks → Add Webhook
- URL de réception de votre serveur
- Sélection des événements à surveiller
- Optionnel : filtrer par liste ou campagne spécifique
Format du payload (exemple email.opened) :
{
"event": "opened",
"email": "contact@example.com",
"id": 12345,
"ts": 1712345678,
"campaignId": 42,
"messageId": "abc123"
}
Cas d’usage des webhooks
Scoring CRM en temps réel :
Chaque ouverture = +5 points dans votre CRM. Chaque clic = +20 points. Déclenchement d’une alerte commerciale si un prospect atteint 100 points.
Nettoyage automatique de liste :
Hard bounce reçu → suppression automatique du contact dans votre base de données client.
Synchronisation bidirectionnelle :
Désinscription dans Brevo → mise à jour du statut marketing dans votre ERP ou CRM pour éviter un réenvoi accidentel.
API d’événements : votre app → Brevo
Principe :
Vous envoyez un événement à l’API Brevo depuis votre application pour déclencher une automation.
Exemple d’utilisation :
Votre SaaS détecte qu’un utilisateur vient d’atteindre sa limite de storage. Vous envoyez un événement storage_limit_reached à Brevo. Une automation configurée sur cet événement envoie automatiquement un email upsell.
Envoi d’un événement via l’API :
POST https://api.brevo.com/v3/trackEvent
{
"email": "user@example.com",
"event": "storage_limit_reached",
"properties": {
"current_usage_gb": 4.8,
"limit_gb": 5
}
}
Utilisation dans les automations :
Dans Brevo → Automations → créez un workflow avec déclencheur « Événement : storage_limit_reached » → envoi email upsell plan Premium.
SDK et librairies disponibles
Brevo propose des SDKs officiels :
- PHP :
brevo/brevo-php - Node.js :
@getbrevo/brevo - Python :
brevo-python - Java :
brevo/brevo-java - Ruby :
getbrevo/brevo-ruby
Installation (Node.js) :
npm install @getbrevo/brevo
Sécurisation des webhooks
Vérifiez l’authenticité des webhooks entrants :
- Brevo envoie un header
X-Brevo-Signaturecontenant un HMAC-SHA256 du payload - Calculez la signature côté serveur avec votre clé secrète et comparez
- Rejetez les requêtes avec signature invalide
Guide pratique pas à pas
Étape 1 : Configuration initiale de votre compte Brevo
La configuration initiale prend environ 30 minutes et conditionne votre délivrabilité long terme. Ne la sautez pas :
Authentification de domaine (OBLIGATOIRE) :
- Connectez-vous à Brevo → Paramètres → Expéditeurs et IP
- Ajoutez votre domaine d’envoi (ex: contact@votreentreprise.fr)
- Copiez les enregistrements SPF, DKIM et DMARC fournis
- Ajoutez ces enregistrements dans la zone DNS de votre hébergeur (OVH, Gandi, Ionos…)
- Attendez 24-48h pour la propagation DNS
- Vérifiez le statut dans Brevo (tout doit passer au vert)
Sans cette étape, vos emails risquent de finir en spam sur Gmail, Outlook et Orange Mail.
Étape 2 : Import et nettoyage de vos contacts
Bonnes pratiques d’import :
- N’importez que des contacts ayant donné un consentement explicite (RGPD)
- Nettoyez votre liste avant import : suppressions des doublons, correction des typos courantes (@gamil.com → @gmail.com)
- Segmentez dès l’import : créez des listes par source d’acquisition
- Historique d’engagement : si vous migrez depuis un autre outil, importez aussi le statut (actif/inactif)
Outil de nettoyage recommandé : Brevo propose un validateur d’emails intégré qui identifie les adresses invalides, jetables ou à risque.
Étape 3 : Création de votre premier formulaire d’inscription
Un formulaire d’inscription bien conçu peut multiplier par 5 votre taux de conversion visiteur → abonné :
- Position optimale : Pop-up avec délai 30 secondes OU exit intent
- Proposition de valeur claire : « Rejoignez 12 000 entrepreneurs et recevez… » vs « Inscrivez-vous à notre newsletter »
- Nombre de champs : 2 maximum (email + prénom) pour maximiser les conversions
- Double opt-in : Activez-le systématiquement pour rester en conformité RGPD et avoir une liste de qualité
Étape 4 : Création et envoi de votre première campagne
Checklist avant envoi :
- [ ] Objet testé sur 2 variantes (A/B test)
- [ ] Prévisualisation mobile vérifiée
- [ ] Lien de désabonnement présent et fonctionnel
- [ ] Adresse physique de l’entreprise dans le pied de page
- [ ] Tous les liens testés et fonctionnels
- [ ] Texte alternatif sur toutes les images
- [ ] Envoi test à votre propre adresse validé
Paramétrage de l’envoi :
- Activez l’optimisation automatique de l’heure d’envoi si vous avez l’historique
- Configurez le suivi Google Analytics pour attribuer les conversions
- Activez les notifications de désabonnement pour votre équipe
Pourquoi choisir Brevo pour votre email marketing ?
L’avantage compétitif décisif : contacts illimités
La quasi-totalité des concurrents facturent en fonction du nombre de contacts, ce qui peut faire exploser votre budget si votre liste croît rapidement. Brevo facture uniquement sur le volume d’emails envoyés, ce qui représente une économie de 40 à 70% pour les bases de données importantes peu sollicitées.
Exemple concret : Vous avez 30 000 contacts mais n’envoyez qu’une newsletter mensuelle. Chez Mailchimp, vous payez le plan « Essentials » à 245€/mois. Chez Brevo, vous payez le plan Business à 79€/mois. Économie annuelle : 1 992€.
La conformité RGPD : un enjeu business, pas juste légal
En 2023, la CNIL a infligé 101 millions d’euros d’amendes à des entreprises françaises pour non-conformité RGPD dans leurs pratiques d’email marketing. Brevo vous protège avec :
- Consentement double opt-in intégré
- Gestion des désabonnements conforme (lien dans chaque email, pris en compte sous 10 jours)
- Registre des traitements exportable
- Demandes de suppression de données gérées automatiquement
- Hébergement EU uniquement (pas de transfert de données hors Europe)
Guide pratique pas à pas
Étape 1 : Configuration initiale de votre compte Brevo
La configuration initiale prend environ 30 minutes et conditionne votre délivrabilité long terme. Ne la sautez pas :
Authentification de domaine (OBLIGATOIRE) :
- Connectez-vous à Brevo → Paramètres → Expéditeurs et IP
- Ajoutez votre domaine d’envoi (ex: contact@votreentreprise.fr)
- Copiez les enregistrements SPF, DKIM et DMARC fournis
- Ajoutez ces enregistrements dans la zone DNS de votre hébergeur (OVH, Gandi, Ionos…)
- Attendez 24-48h pour la propagation DNS
- Vérifiez le statut dans Brevo (tout doit passer au vert)
Sans cette étape, vos emails risquent de finir en spam sur Gmail, Outlook et Orange Mail.
Étape 2 : Import et nettoyage de vos contacts
Bonnes pratiques d’import :
- N’importez que des contacts ayant donné un consentement explicite (RGPD)
- Nettoyez votre liste avant import : suppressions des doublons, correction des typos courantes (@gamil.com → @gmail.com)
- Segmentez dès l’import : créez des listes par source d’acquisition
- Historique d’engagement : si vous migrez depuis un autre outil, importez aussi le statut (actif/inactif)
Outil de nettoyage recommandé : Brevo propose un validateur d’emails intégré qui identifie les adresses invalides, jetables ou à risque.
Étape 3 : Création de votre premier formulaire d’inscription
Un formulaire d’inscription bien conçu peut multiplier par 5 votre taux de conversion visiteur → abonné :
- Position optimale : Pop-up avec délai 30 secondes OU exit intent
- Proposition de valeur claire : « Rejoignez 12 000 entrepreneurs et recevez… » vs « Inscrivez-vous à notre newsletter »
- Nombre de champs : 2 maximum (email + prénom) pour maximiser les conversions
- Double opt-in : Activez-le systématiquement pour rester en conformité RGPD et avoir une liste de qualité
Étape 4 : Création et envoi de votre première campagne
Checklist avant envoi :
- [ ] Objet testé sur 2 variantes (A/B test)
- [ ] Prévisualisation mobile vérifiée
- [ ] Lien de désabonnement présent et fonctionnel
- [ ] Adresse physique de l’entreprise dans le pied de page
- [ ] Tous les liens testés et fonctionnels
- [ ] Texte alternatif sur toutes les images
- [ ] Envoi test à votre propre adresse validé
Paramétrage de l’envoi :
- Activez l’optimisation automatique de l’heure d’envoi si vous avez l’historique
- Configurez le suivi Google Analytics pour attribuer les conversions
- Activez les notifications de désabonnement pour votre équipe
Guide pratique pas à pas
Étape 1 : Configuration initiale de votre compte Brevo
La configuration initiale prend environ 30 minutes et conditionne votre délivrabilité long terme. Ne la sautez pas :
Authentification de domaine (OBLIGATOIRE) :
- Connectez-vous à Brevo → Paramètres → Expéditeurs et IP
- Ajoutez votre domaine d’envoi (ex: contact@votreentreprise.fr)
- Copiez les enregistrements SPF, DKIM et DMARC fournis
- Ajoutez ces enregistrements dans la zone DNS de votre hébergeur (OVH, Gandi, Ionos…)
- Attendez 24-48h pour la propagation DNS
- Vérifiez le statut dans Brevo (tout doit passer au vert)
Sans cette étape, vos emails risquent de finir en spam sur Gmail, Outlook et Orange Mail.
Étape 2 : Import et nettoyage de vos contacts
Bonnes pratiques d’import :
- N’importez que des contacts ayant donné un consentement explicite (RGPD)
- Nettoyez votre liste avant import : suppressions des doublons, correction des typos courantes (@gamil.com → @gmail.com)
- Segmentez dès l’import : créez des listes par source d’acquisition
- Historique d’engagement : si vous migrez depuis un autre outil, importez aussi le statut (actif/inactif)
Outil de nettoyage recommandé : Brevo propose un validateur d’emails intégré qui identifie les adresses invalides, jetables ou à risque.
Étape 3 : Création de votre premier formulaire d’inscription
Un formulaire d’inscription bien conçu peut multiplier par 5 votre taux de conversion visiteur → abonné :
- Position optimale : Pop-up avec délai 30 secondes OU exit intent
- Proposition de valeur claire : « Rejoignez 12 000 entrepreneurs et recevez… » vs « Inscrivez-vous à notre newsletter »
- Nombre de champs : 2 maximum (email + prénom) pour maximiser les conversions
- Double opt-in : Activez-le systématiquement pour rester en conformité RGPD et avoir une liste de qualité
Étape 4 : Création et envoi de votre première campagne
Checklist avant envoi :
- [ ] Objet testé sur 2 variantes (A/B test)
- [ ] Prévisualisation mobile vérifiée
- [ ] Lien de désabonnement présent et fonctionnel
- [ ] Adresse physique de l’entreprise dans le pied de page
- [ ] Tous les liens testés et fonctionnels
- [ ] Texte alternatif sur toutes les images
- [ ] Envoi test à votre propre adresse validé
Paramétrage de l’envoi :
- Activez l’optimisation automatique de l’heure d’envoi si vous avez l’historique
- Configurez le suivi Google Analytics pour attribuer les conversions
- Activez les notifications de désabonnement pour votre équipe
[CTA:brevo]
Guide Emailing