Brevo webhooks et API events : guide pratique pour développeurs

✅ 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

---

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 ouvert
• email.clicked : lien cliqué (avec l’URL cliquée)
• email.delivered : email délivré
• email.hardbounce : bounce définitif
• email.softbounce : bounce temporaire
• email.spam : marqué comme spam
• email.unsubscribe : désabonnement
• contact.created : nouveau contact
• contact.updated : contact mis à jour

Configuration :

1. Brevo → Settings → Webhooks → Add Webhook
2. URL de réception de votre serveur
3. Sélection des événements à surveiller
4. 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-Signature contenant 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) :

1. Connectez-vous à Brevo → Paramètres → Expéditeurs et IP
2. Ajoutez votre domaine d’envoi (ex: contact@votreentreprise.fr)
3. Copiez les enregistrements SPF, DKIM et DMARC fournis
4. Ajoutez ces enregistrements dans la zone DNS de votre hébergeur (OVH, Gandi, Ionos…)
5. Attendez 24-48h pour la propagation DNS
6. 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) :

1. Connectez-vous à Brevo → Paramètres → Expéditeurs et IP
2. Ajoutez votre domaine d’envoi (ex: contact@votreentreprise.fr)
3. Copiez les enregistrements SPF, DKIM et DMARC fournis
4. Ajoutez ces enregistrements dans la zone DNS de votre hébergeur (OVH, Gandi, Ionos…)
5. Attendez 24-48h pour la propagation DNS
6. 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) :

1. Connectez-vous à Brevo → Paramètres → Expéditeurs et IP
2. Ajoutez votre domaine d’envoi (ex: contact@votreentreprise.fr)
3. Copiez les enregistrements SPF, DKIM et DMARC fournis
4. Ajoutez ces enregistrements dans la zone DNS de votre hébergeur (OVH, Gandi, Ionos…)
5. Attendez 24-48h pour la propagation DNS
6. 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

A lire aussi

– Lire aussi
– Lire aussi
– Lire aussi
– Brevo reporting avancé