L’envoi de webhooks sortants depuis une automatisation vous permet d’envoyer une notification en temps réel avec les données de l’événement de Brevo vers une application externe lorsqu’un contact atteint l'étape Appeler un webhook.
Cet article explique comment envoyer des webhooks sortants depuis une automatisation. Vous pouvez également créer des webhooks sortants en les configurant directement dans votre compte Brevo ou depuis l'API.
Avant de commencer
Dans votre application externe, veillez à récupérer l’URL du serveur ou du point de terminaison auquel vous souhaitez envoyer le webhook sortant. Si vous ne savez pas où la récupérer, consultez le centre d’aide de votre application externe ou contactez son équipe d’assistance.
Envoyer des webhooks sortants depuis une automatisation
Pour envoyer des webhooks sortants depuis une automatisation, vous devez ajouter l'étape Appeler un webhook et la configurer avec l'URL de votre webhook et vos informations d'authentification.
Utilisez les onglets suivants pour consulter les instructions relatives au nouvel éditeur d'automatisation ou à l’éditeur d’automatisation classique :
- Dans une automatisation créée à l’aide du nouvel éditeur, ajoutez l’étape Appeler un webhook.
- 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.
- Sélectionnez une méthode d’authentification dans la liste déroulante :
- Aucune authentification : Le webhook sera envoyé sans identifiants d’authentification.
- Basic : Saisissez votre nom d’utilisateur et votre mot de passe. Brevo encodera ces identifiants et les enverra avec chaque requête de webhook.
- Jeton : Saisissez votre jeton d'authentification. Brevo enverra ce jeton avec chaque requête de webhook.
-
(Facultatif) Cliquez sur Ajouter un objet pour ajouter des en-têtes personnalisés à votre requête de webhook. Saisissez le nom et la valeur de l'en-tête. Vous pouvez ajouter plusieurs en-têtes si besoin.
💡 Bon à savoirLes en-têtes personnalisés sont utiles pour l’authentification ou pour transmettre des métadonnées supplémentaires à votre application externe. - (Facultatif) Dans la section Paramètres supplémentaires, configurez les données incluses dans le webhook :
- Inclure les informations relatives au contact qui a déclenché l'événement : Lorsqu’elle est activée, Brevo inclut tous les attributs du contact dans le webhook. Par défaut, seuls l’ID du contact, l’email, l’ID de l’étape et l’ID du scénario sont inclus.
- Inclure les détails de l’événement déclencheur : Lorsqu’elle est activée, Brevo inclut les données d’événement de la charge utile dans le webhook.
- Cliquez sur Enregistrer pour enregistrer l’étape.
- Terminez la configuration de votre automatisation et activez-la.
- À partir d’une automatisation créée à l’aide de l’éditeur classique, ajoutez un point d’entrée.
- (Facultatif) Ajoutez les étapes que vous souhaitez que vos contacts suivent avant de déclencher le webhook.
- Ajoutez l’étape Appeler un webhook à votre automatisation :
- Sur le canevas, cliquez sur + à l’endroit où vous souhaitez ajouter l'étape Appeler un webhook.
- Sélectionnez l'étape Appeler un webhook.
-
Collez l’URL du webhook fournie par votre application externe. Cette URL de rappel indique à Brevo où envoyer les données lorsqu’un événement se produit.
💡 Bon à savoirL’URL du webhook doit être générée et récupérée depuis votre application externe. Si vous ne savez pas où la récupérer, consultez le centre d’aide de votre application externe ou contactez son équipe d’assistance. - (Facultatif) Activez l’option Je veux envoyer les propriétés du contact dans le webhook pour inclure les propriétés du contact dans le webhook.
- Cliquez sur OK.
- Terminez la configuration de votre automatisation et activez-la.
Sécuriser vos webhooks sortants
Pour sécuriser vos webhooks sortants, ajoutez à 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.
⏭️ Et après ?
- Créer des webhooks sortants pour envoyer des données en temps réel de Brevo vers une application externe
- Créer des webhooks entrants pour recevoir des données en temps réel d'une autre application dans Brevo
🤔 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.