## EN BREF
✅ L’API Brevo est complète, bien documentée et supporte Python, Node.js, PHP, Go, Ruby, Java
✅ Idéale pour les emails transactionnels depuis vos apps avec tracking complet
⚠️ Pour les volumes > 100K emails/jour, discutez de limites de débit avec le support Brevo
[CTA:brevo-essai-gratuit]
—
Brevo api documentation est au cœur de cet article. Brevo api documentation est au cœur de cet article. Brevo api documentation est au cœur de cet article. L’API Brevo couvre deux cas d’usage majeurs : l’envoi d’emails transactionnels depuis vos applications, et la gestion programmatique de vos listes et campagnes marketing. Voici comment bien l’utiliser.
## Authentification
Toutes les requêtes API Brevo utilisent une clé API dans le header HTTP.
**Générer votre clé :** Brevo → Paramètres → SMTP & API → Clés API → Créer
« `http
GET https://api.brevo.com/v3/account
Accept: application/json
api-key: VOTRE_CLE_API
« `
Conservez votre clé dans les variables d’environnement — jamais en dur dans le code.
## Envoyer un email transactionnel
### Avec le SDK officiel Python
« `bash
pip install sib-api-v3-sdk
« `
« `python
import sib_api_v3_sdk
from sib_api_v3_sdk.rest import ApiException
configuration = sib_api_v3_sdk.Configuration()
configuration.api_key[‘api-key’] = ‘VOTRE_CLE_API’
api_instance = sib_api_v3_sdk.TransactionalEmailsApi(
sib_api_v3_sdk.ApiClient(configuration)
)
send_smtp_email = sib_api_v3_sdk.SendSmtpEmail(
to=[{« email »: « client@exemple.com », « name »: « Jean Dupont »}],
template_id=42, # ID du template dans Brevo
params={« prenom »: « Jean », « commande »: « #12345 »},
sender={« email »: « noreply@votre-site.com », « name »: « Votre Boutique »}
)
try:
response = api_instance.send_transac_email(send_smtp_email)
print(f »Email envoyé, ID: {response.message_id} »)
except ApiException as e:
print(f »Erreur: {e} »)
« `
### Avec Node.js
« `bash
npm install @getbrevo/brevo
« `
« `javascript
const SibApiV3Sdk = require(‘@getbrevo/brevo’);
const apiInstance = new SibApiV3Sdk.TransactionalEmailsApi();
apiInstance.authentications[‘api-key’].apiKey = ‘VOTRE_CLE_API’;
const sendSmtpEmail = new SibApiV3Sdk.SendSmtpEmail();
sendSmtpEmail.to = [{email: ‘client@exemple.com’, name: ‘Jean Dupont’}];
sendSmtpEmail.templateId = 42;
sendSmtpEmail.params = {prenom: ‘Jean’, commande: ‘#12345’};
sendSmtpEmail.sender = {email: ‘noreply@votre-site.com’};
apiInstance.sendTransacEmail(sendSmtpEmail)
.then(data => console.log(‘Envoyé:’, data.messageId))
.catch(err => console.error(‘Erreur:’, err));
« `
## Gérer les contacts
### Créer ou mettre à jour un contact
« `python
api_instance = sib_api_v3_sdk.ContactsApi(
sib_api_v3_sdk.ApiClient(configuration)
)
create_contact = sib_api_v3_sdk.CreateContact(
email=’nouveau@exemple.com’,
attributes={
‘PRENOM’: ‘Marie’,
‘NOM’: ‘Dupont’,
‘PLAN’: ‘pro’,
‘DATE_INSCRIPTION’: ‘2025-04-03′
},
list_ids=[5], # ID de la liste dans Brevo
update_enabled=True # Met à jour si existe déjà
)
try:
api_instance.create_contact(create_contact)
except ApiException as e:
print(e)
« `
### Déclencher un événement custom pour les automatisations
« `python
track_event = sib_api_v3_sdk.TrackEvent(
email=’client@exemple.com’,
event=’achat_complete’,
eventdata=sib_api_v3_sdk.TrackEventEventdata(
data={‘montant’: 99.90, ‘produit’: ‘Formation Email Marketing’}
)
)
event_api = sib_api_v3_sdk.TrackingApi(
sib_api_v3_sdk.ApiClient(configuration)
)
event_api.track_event(track_event)
« `
Cet événement peut déclencher une automatisation Brevo configurée pour réagir à l’événement ‘achat_complete’.
## Les webhooks : réagir aux événements email
Les webhooks vous permettent d’être notifié en temps réel quand quelque chose se passe côté email.
**Événements disponibles :**
– `delivered` : email délivré avec succès
– `opened` : email ouvert
– `clicked` : lien cliqué
– `hardBounce` / `softBounce` : rebond
– `unsubscribed` : désabonnement
– `spam` : signalé comme spam
**Configurer les webhooks :** Brevo → Paramètres → Webhooks → Ajouter
**Exemple de payload reçu :**
« `json
{
« event »: « clicked »,
« email »: « client@exemple.com »,
« id »: 12345,
« date »: « 2025-04-03T14:22:00Z »,
« url »: « https://votre-site.com/voir-offre »,
« messageId »: «
}
« `
**Cas d’usage concret :** Quand un contact clique sur « Voir la proposition » dans un email → webhook → votre CRM crée une tâche « Appeler ce lead maintenant » → Slack notification à votre commercial.
## Templates d’emails dans Brevo
Pour les emails transactionnels, créez des templates dans l’interface Brevo et référencez-les par leur ID dans l’API. Avantages :
– Modifiez le design sans toucher au code
– Prévisualisez dans l’interface avant mise en prod
– L’équipe marketing peut modifier les textes sans développeur
**Utiliser les variables dans les templates :**
Dans l’éditeur Brevo, utilisez : `{{ params.prenom }}` et `{{ params.montant }}`.
Dans l’API, passez ces variables dans l’objet `params` :
« `python
params={« prenom »: « Jean », « montant »: « 99.90€ »}
« `
## Limites de débit (rate limiting)
| Plan | Emails transactionnels/jour | Requêtes API/heure |
|——|—————————-|——————–|
| Gratuit | 300 | 50 |
| Starter | Selon plan | 200 |
| Business | Selon plan | 500 |
| Enterprise | Sur mesure | 1000+ |
Pour les pics de volume (lancement, Black Friday), prévenez le support Brevo — ils peuvent augmenter temporairement vos limites.
## Bonnes pratiques
**Gestion des erreurs :** Implémentez une logique de retry avec backoff exponentiel pour les erreurs 429 (rate limit) et 503 (service indisponible). Pour les erreurs 400 (mauvais paramètres) et 422 (email invalide), ne retentez pas — corrigez le code.
**Logging :** Conservez le `messageId` de chaque email envoyé. Il vous permettra de retrouver l’email dans Brevo et de diagnostiquer les problèmes de délivrabilité.
**Variables d’environnement :** Jamais la clé API en dur dans le code. `.env` ou secrets manager cloud.
## 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
[CTA:brevo-essai-gratuit]
[IMAGE:api-integration-developer-code-diagram-indigo-tech-icons-flat-design-no-people]