Connecter Brevo
Le connecteur Brevo vérifie vos listes de contacts et écrit le résultat sur chaque contact, sous forme d'attributs. Le principe commun à tous les connecteurs est décrit dans Connecteurs : principe.
1. Créer une clé API Brevo
- Dans Brevo, ouvrez le menu du compte (en haut à droite), puis SMTP & API.
- Onglet Clés API, cliquez Générer une nouvelle clé API.
- Nommez-la, par exemple
YesWeCheck, et copiez-la : Brevo ne l'affiche qu'une fois.
Une clé dédiée vous permet de couper l'accès de YesWeCheck sans toucher à vos autres intégrations.
Si le blocage des adresses IP inconnues est actif sur votre compte Brevo, Brevo refuse les appels de YesWeCheck tant que son adresse n'est pas autorisée. La page du connecteur, dans l'espace client, affiche cette adresse (IPv4, fixe) avec un bouton pour la copier.
Dans Brevo : cliquez sur votre nom en haut à droite, puis Sécurité, onglet IP autorisées, et ajoutez l'adresse. Faites-le avant de connecter ; sinon, la connexion est refusée et le message rappelle l'adresse à autoriser.
2. Connecter
Dans l'espace client : Intégrer → Connecteurs → Brevo, collez la clé, puis Tester et connecter. Le nom de votre compte Brevo s'affiche quand la clé est acceptée. Une clé refusée n'est pas enregistrée.
3. Nettoyer une liste
Choisissez une liste, un segment ou Tous les contacts, puis Lancer le nettoyage. Trois étapes :
- YesWeCheck lit les contacts dans Brevo.
- Les adresses sont vérifiées comme un traitement par lots : vous suivez la progression dans Traitement par lot, où le lot porte le badge Brevo.
- À la fin, les résultats sont écrits dans Brevo. Une notification vous en donne le bilan.
Un seul traitement par lots peut tourner à la fois dans une organisation : un nettoyage attend la fin d'un lot en cours.
Ce qui est écrit dans Brevo
Au premier nettoyage, YesWeCheck crée quatre attributs de contact s'ils n'existent pas :
| Attribut | Type Brevo | Contenu |
|---|---|---|
YWC_STATUS | Texte | valid, risky, invalid ou unknown |
YWC_SCORE | Nombre | 0 à 100 |
YWC_REASON | Texte | Motif (voir la liste des motifs) |
YWC_LAST_CHECK | Date | Jour de la vérification |
Pour exclure les adresses à risque de vos campagnes, créez dans Brevo un segment sur YWC_STATUS (par exemple « est égal à invalid ») et excluez-le de vos envois.
Options
| Option | Par défaut | Effet dans Brevo |
|---|---|---|
| Regrouper les adresses invalides | Désactivée | Ajoute les contacts invalid à la liste YWC – invalides (dossier YesWeCheck) |
| Bloquer les adresses invalides | Désactivée | Passe les contacts invalid en liste noire email. Ils ne reçoivent plus aucun email, transactionnel compris |
| Ignorer les contacts déjà bloqués ou désinscrits | Activée | Ces contacts ne sont ni vérifiés ni facturés |
Vérifier automatiquement les nouveaux contacts
Activez Vérifier automatiquement les nouveaux contacts, choisissez les listes à surveiller et un plafond journalier. YesWeCheck crée alors dans Brevo un webhook « ajout à une liste » (visible dans Brevo, section webhooks marketing, description « YesWeCheck — validation des nouveaux contacts »).
Chaque contact ajouté à une liste surveillée est vérifié, SMTP compris, et ses attributs sont remplis dans la minute. Le plafond journalier borne la consommation de crédits ; au-delà, les nouveaux contacts du jour ne sont pas vérifiés.
Désactiver l'option, ou déconnecter Brevo, supprime ce webhook.
Déconnecter
Déconnecter efface la clé chez YesWeCheck et supprime le webhook dans Brevo. Les attributs YWC_* déjà écrits restent sur vos contacts ; supprimez-les dans Brevo si vous n'en voulez plus.
Pour couper l'accès immédiatement, côté Brevo, supprimez la clé API dédiée.
Dépannage
| Message | Cause | Que faire |
|---|---|---|
| « Clé refusée par l'outil » | Clé incomplète, supprimée ou désactivée | Générez une nouvelle clé et reconnectez |
| « Son option IP autorisées est active » | Restriction d'adresse IP du compte Brevo | Autorisez l'adresse de YesWeCheck dans Brevo |
| « L'outil limite temporairement les appels » | Quota d'appels Brevo atteint | Le traitement reprend seul ; sinon réessayez plus tard |
| « Un traitement par lot est déjà en cours » | Un autre lot tourne dans l'organisation | Attendez sa fin |
| Connexion À reconnecter | Brevo refuse la clé enregistrée | Saisissez une clé valide sur la page du connecteur |