Les webhooks sortants vous permettent d’envoyer des données en temps réel de Brevo vers une application externe. Lorsqu’un événement spécifique se produit dans Brevo, votre application externe reçoit une notification contenant les détails de l’événement.

Vous pouvez créer des webhooks sortants pour les événements liés aux fonctionnalités Brevo suivantes :

Bon à savoir

• Vous pouvez créer jusqu’à 40 webhooks sortants dans votre compte Brevo. Si vous atteignez cette limite, supprimez un webhook existant avant d’en créer un nouveau.
• Les webhooks sortants peuvent également être créés via une automatisation ou l’API.
• Si vous souhaitez créer des webhooks entrants pour recevoir des données en temps réel d’une autre application dans Brevo, consultez notre article dédié Créer des webhooks entrants pour recevoir des données en temps réel d'une autre application dans Brevo.

Avant de commencer

Depuis votre application externe, veillez à récupérer les éléments suivants :

• L'URL du serveur ou du point de terminaison auquel vous souhaitez envoyer le webhook sortant
• (Facultatif) La méthode d'authentification et les informations d'identification requises
• Tout nom et valeur d’en-tête requis

Si vous ne savez pas où récupérer ces informations, consultez le centre d’aide de votre application externe ou contactez son équipe d’assistance.

Étape 1 : créez un webhook sortant dans Brevo

Pour créer un webhook sortant dans Brevo :

1. Dans Brevo, cliquez sur le nom de votre compte et sélectionnez Intégrations > Webhooks.
2. Cliquez sur Ajouter un webhook.
   
3. Sélectionnez Webhook sortant.
4. Cliquez sur Ajouter un webhook.
   

Étape 2 : configurez le webhook sortant

Ensuite, configurez le nom, l’URL et la méthode d’authentification du webhook sortant.

1. Saisissez un nom pour le webhook.
2. Cliquez sur Continuer.
3. Saisissez l’URL du serveur ou du point de terminaison auquel vous souhaitez envoyer vos événements. Cela indique à Brevo où envoyer le webhook sortant lorsqu’un événement se produit.
   
4. (Facultatif) Par défaut, Pas d'authentification est sélectionnée comme méthode d'authentification. Pour ajouter un niveau de sécurité supplémentaire, ou si l’application externe à laquelle vous envoyez le webhook l’exige, vous pouvez choisir :
   • authentification de base (nom d'utilisateur et mot de passe), ou
   • authentification par jeton
     
5. (Facultatif) Pour ajouter un en-tête à votre webhook sortant :
   1. Cliquez sur + Ajouter un objet.
   2. Saisissez le nom et la valeur de l'en-tête.
      
6. Sélectionnez votre stratégie d’envoi de webhook :
   • Envoyer un à la fois
     Envoyer des événements individuellement en temps réel.
   • Envoyer par lots
     Envoyer des événements par lots de 500 maximum. Cette option est recommandée si vous avez des limites de débit plus faibles, car cela peut réduire le nombre de requêtes.
7. Cliquez sur Continuer.

Étape 3 : choisissez les événements et envoyez les requêtes test

Enfin, choisissez les événements pour lesquels vous souhaitez recevoir le webhook sortant et envoyez des requêtes test à votre application externe.

1. Sélectionnez la catégorie d’événement pour laquelle vous souhaitez créer un webhook sortant (par exemple, Email transactionnel, Opportunités, Formulaires, etc.).
   
   💡 Bon à savoir

   Les événements des contacts se trouvent dans la catégorie d'événement Emails marketing.
2. Par défaut, tous les événements de la catégorie sélectionnée sont activés. Si nécessaire, vous pouvez désactiver des événements spécifiques en désactivant leur bouton bascule.
   
3. (Facultatif) Pour envoyer des requêtes test pour les événements :
   1. Cliquez sur l’icône des trois points à côté d’un événement et sélectionnez Envoyer une requête test.
      
   2. Vérifiez votre application externe pour confirmer que vous avez reçu le webhook sortant.
4. Cliquez sur Activer le webhook lorsque vous avez terminé.

Sécuriser vos webhooks sortants

Pour sécuriser vos webhooks sortants, vous devez ajouter à la liste d'autorisation certaines des plages IP de Brevo. Cela permet de s’assurer que seules les requêtes autorisées peuvent déclencher les webhooks. 

➡️ Pour en savoir plus, consultez notre article dédié Plages IP de Brevo : liste des services exposés publiquement.

Supprimer un webhook sortant

Si vous n’avez plus besoin d’un webhook sortant, vous pouvez le supprimer définitivement.

1. Dans Brevo, cliquez sur le nom de votre compte et sélectionnez Intégrations.
2. Accédez à l'onglet Webhooks.
3. Sélectionnez l’option Webhook sortant.
4. À côté du webhook sortant que vous souhaitez supprimer, cliquez sur l’icône de la corbeille 🗑️.
   
5. Cliquez sur Supprimer le webhook pour confirmer.

Le webhook sortant est définitivement supprimé.

🤔 Vous avez des questions ?

Pour toute question, n’hésitez pas à contacter notre service client en créant un ticket à partir de votre compte. Si vous n’avez pas encore de compte, vous pouvez nous contacter ici.

Si vous avez besoin d'aide pour un projet impliquant Brevo, nous pouvons vous mettre en relation avec une agence partenaire Brevo.