Sommaire
- Introduction
- Partie 1 : Envoyer une vue de liste vers Brevo
- Partie 2 : Recevoir les événements des emails Brevo
Introduction
Brevo est un outil de marketing automation qui envoie des emails à une liste de contacts et indique quels emails ont été ouverts, cliqués ou désabonnés. Cirrus Shield fonctionne avec Brevo (anciennement Sendinblue) de deux façons distinctes. Chacune utilise sa propre extension ; vous pouvez utiliser l’une, l’autre ou les deux.
| Partie 1 : Envoyer une vue de liste vers Brevo | Partie 2 : Recevoir les événements des emails Brevo | |
|---|---|---|
| Extension | Brevo | SendinBlue Connector |
| Rôle | Envoie des Pistes ou des Contacts de Cirrus Shield vers Brevo avec le bouton Upload to Brevo | Enregistre dans Cirrus Shield les ouvertures, clics, désinscriptions, signalements de spam et hard bounces de vos campagnes Brevo |
| Mise en place | Vous (administrateur) | L’équipe Cirrus Shield l’installe ; vous connectez Brevo |
Partie 1 : Envoyer une vue de liste vers Brevo (extension Brevo)
Tout d’abord, créez un compte dans « Brevo ».
Voici les 4 étapes pour synchroniser les informations entre Cirrus Shield et Brevo:
Etape 1: Paramétrer l’extension Brevo dans Cirrus Shield :
1- Allez dans Configuration et cliquez sur l’onglet Extensions.
2- Cliquez sur Nouveau et sélectionnez Brevo.
3- Cliquez sur Installer.
4- Une fois l’extension installée, cliquez sur Détails à côté de l’intégration Brevo.
5- Cliquez sur Modifier.
6- Copiez la Clé API V3 présente dans votre compte Brevo. Pour cela, connectez-vous et cliquez sur l’onglet API & Forms, puis sur Gérer vos clés. Copiez le « API Key » et mettez-le dans le champ « Authentication ID » présent dans Cirrus Shield.
7- Enregistrer les modifications.
Etape 2: Choisir quel objet vous souhaitez migrer dans la liste de contact de Brevo:
1- Cliquez sur Détails à côté du plugin Brevo.
2- Allez à la section « Plugin Component ».
3- Cliquez sur Modifier à côté de « Upload to Brevo ».
4- Sélectionnez les objets que vous souhaitez migrer dans Brevo. Dans la plupart des cas, il s’agira de l’objet Prospect ou de l’objet Contact.
5- Cliquez sur Enregistrer.
Etape 3 : Mapper les champs de Cirrus Shield avec les champs de Brevo:
1- Cliquez sur « Upload to Brevo ».
2- Allez sur « Component Mapping Fields » et cliquez sur Modifier.
3- Mapper les champs de Brevo avec les champs de Cirrus Shield.
4- Cliquez sur Enregistrer.
Etape 4: Sélectionnez les profils qui peuvent migrer des informations dans Brevo (à faire par objet) :
1- Cliquez sur l’onglet Objets.
2- Sur chacun des objets sur lesquels vous avez ajouté Brevo, cliquez sur Détails puis sur l’onglet « Boutons personnalisés« .
3- Cliquez sur « Détails » à côté du bouton « Upload to Brevo ».
4- Cliquez sur l’onglet Profils puis modifier.
5- Ajoutez tous les profils auxquels vous souhaitez donner accès au bouton puis cliquez sur Enregistrer.
Cette partie n’a pas besoin des champs de la Partie 2 et ne ramène rien de Brevo. Pour voir les ouvertures, clics et désinscriptions dans Cirrus Shield, mettez en place la Partie 2.
Partie 2 : Recevoir les événements des emails Brevo (SendinBlue Connector)
Fonctionnement
Brevo envoie chaque événement de vos campagnes au SendinBlue Connector, qui l’enregistre dans Cirrus Shield au plus tard environ une heure après.
| Événement dans Brevo | Résultat dans Cirrus Shield |
|---|---|
| Opened (ouvert) | Une campagne Campaign-<numéro de campagne Brevo> est créée si besoin, ainsi qu’un membre de campagne avec Email ouvert coché |
| Clicked (cliqué) | Idem, avec Email cliqué coché |
| Unsubscribed (désinscrit), Complaint (marqué comme spam) | Désabonnement emails coché sur les Contacts et Pistes ayant cette adresse |
| Hard Bounced | Email invalide coché sur les Contacts et Pistes ayant cette adresse |
- Les membres de campagne ne sont créés que pour les destinataires qui existent déjà comme Contact ou Piste dans Cirrus Shield.
- Les campagnes et membres de campagne appartiennent à l’utilisateur associé de l’application connectée du connecteur.
- Le connecteur utilise une connexion sécurisée (OAuth) : aucun nom d’utilisateur ni mot de passe Cirrus Shield n’est saisi dans Brevo.
Avant de commencer
- Vous êtes administrateur de l’organisation et disposez d’un compte Brevo.
- Le SendinBlue Connector est installé dans votre organisation par l’équipe Cirrus Shield : l’extension, son application connectée SendinBlue Connector Confidentiel et les champs ci-dessous. Si l’extension est absente, contactez le support Cirrus Shield.
- L’application connectée a un utilisateur associé (Configuration → Applications connectées). Cet utilisateur devient le propriétaire des campagnes et membres de campagne ; il doit pouvoir lire les utilisateurs.
Objets et champs nécessaires au connecteur. Les champs standard existent déjà ; l’équipe Cirrus Shield crée les champs personnalisés qui manquent (les organisations qui utilisaient la version précédente les ont déjà) :
| Nom technique de l’objet | Nom technique du champ | Type |
|---|---|---|
| Contact | Email | Champ standard |
| Contact | Email_Opt_Out | Case à cocher |
| Contact | Invalid_Email | Case à cocher |
| Lead (Piste) | Email | Champ standard |
| Lead (Piste) | Email_Opt_Out | Case à cocher |
| Lead (Piste) | Invalid_Email | Case à cocher |
| Campaign | Name | Champ standard |
| Campaign | SIB_Campaign_ID | Texte, ID externe, unique |
| Campaign | OwnerId | Champ standard |
| Campaign_Member | Campaign | Champ standard (campagne) |
| Campaign_Member | Member | Champ standard (Contact ou Piste) |
| Campaign_Member | SIB_Campaign_Member_ID | Texte, ID externe, unique |
| Campaign_Member | OwnerId | Champ standard |
| Campaign_Member | Email_Opened | Case à cocher |
| Campaign_Member | Email_Clicked | Case à cocher |
Ne supprimez pas et ne renommez pas ces champs : le connecteur utilise exactement ces noms techniques. Vous pouvez ajouter ces champs à vos mises en page avec le Page Designer.
Ouvrir le connecteur
- Ouvrez Configuration, cliquez sur Extensions, trouvez SendinBlue Connector et cliquez sur Détails. Si l’extension n’est pas encore installée, installez-la sans modifier ses paramètres, puis cliquez sur Détails.
- La page du connecteur s’ouvre dans Cirrus Shield. Elle affiche Le connecteur est configuré, le serveur et le propriétaire des enregistrements, ainsi que votre URL de webhook (
https://sib.cirrus-shield.net/brevo?key=…).
L’ouverture de cette page met à jour les identifiants du connecteur. C’est normal : vous pouvez l’ouvrir aussi souvent que vous le souhaitez, l’URL de webhook ne change jamais. Cette URL est personnelle : ne la partagez pas.
Connecter Brevo
- Sur la page du connecteur, cliquez sur Copier à côté de l’URL de webhook.
- Dans Brevo, ouvrez la page des webhooks : https://my.brevo.com/advanced/webhook/ (Plugins & Integrations → Webhooks).
- Cliquez sur Add webhook, choisissez Outbound webhook puis cliquez sur Add webhook. Donnez un nom au webhook dans Name (par exemple Cirrus Shield) et cliquez sur Continue.
- Dans URL, collez l’URL et laissez Authentication method sur No authentication (la clé contenue dans l’URL identifie votre organisation). Cliquez sur Continue.
- Dans Event category, choisissez Marketing email. Tous les événements sont activés : laissez activés uniquement Opened, Clicked, Unsubscribed, Hard Bounced et Complaint (marqué comme spam), désactivez les autres, puis cliquez sur Activate webhook.
Pour vérifier : envoyez une campagne à une petite liste contenant votre propre adresse (qui doit exister comme Contact ou Piste), ouvrez l’email, puis cherchez la campagne Campaign-<numéro> dans Cirrus Shield environ une heure plus tard.
Email d’alerte
Sur la page du connecteur, Email d’alerte est l’adresse à laquelle le connecteur écrit s’il cesse de fonctionner (par exemple si l’application connectée est désactivée). Modifiez-la si besoin et cliquez sur Enregistrer.
Passer de la version précédente
L’ancienne adresse de webhook, qui contenait
un=etpw=(ouindex.php/index2.php), cesse de fonctionner le 18-11-2026. Avant cette date : ouvrez le connecteur (ci-dessus), ajoutez le nouveau webhook dans Brevo, puis supprimez l’ancien webhook dans Brevo, sinon chaque événement arrive en double.
En cas de problème
| Ce que vous voyez | Que vérifier |
|---|---|
| La page du connecteur indique Cette page doit être ouverte depuis Cirrus Shield | L’extension n’est pas installée ou son application connectée est inactive. Installez l’extension dans Configuration → Extensions, puis cliquez de nouveau sur Détails |
| Les identifiants de l’application connectée ont été refusés | Vérifiez que l’application connectée SendinBlue Connector Confidentiel est active, puis rouvrez le connecteur |
| L’application connectée n’a pas d’utilisateur associé | Dans Configuration → Applications connectées, choisissez un utilisateur associé pour l’application, puis rouvrez le connecteur |
| L’utilisateur associé … est déjà utilisé par une autre application connectée | Contactez le support Cirrus Shield |
| Ce formulaire a expiré | Rouvrez le connecteur depuis Cirrus Shield |
| Vous avez reçu un email d’alerte, ou plus rien n’arrive dans Cirrus Shield | Rouvrez le connecteur (cela met à jour ses identifiants). Vérifiez que l’URL saisie dans Brevo est celle affichée sur la page, et que le webhook a la catégorie Marketing email avec les cinq événements |
| Un email a été ouvert mais aucun membre de campagne n’apparaît | Le destinataire n’existe pas comme Contact ou Piste avec la même adresse dans Cirrus Shield, ou le traitement horaire n’a pas encore eu lieu |
| Chaque événement arrive en double | Un ancien webhook Cirrus Shield (avec un= et pw=) est encore actif dans Brevo : supprimez-le |
Pour comprendre comment utiliser le bouton Brevo, consultez Gestion d’utilisateur – Intégration Brevo.
