Recherche

Webhooks classiques : créer des webhooks sortants pour envoyer des données en temps réel de Brevo vers une application externe

Cet article couvre l’expérience classique de la gestion des webhooks. Pour en savoir plus sur la nouvelle expérience, consultez notre article dédié Nouveaux webhooks : créer des webhooks sortants pour envoyer des données en temps réel de Brevo vers une application externe.

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.

Bon à savoir

  • Vous pouvez créer jusqu’à 40 webhooks sortants dans votre compte Brevo. En cas de dépassement de cette limite, supprimez un webhook existant pour en créer un nouveau.
  • Vous pouvez également créer des webhooks sortants depuis une automatisation ou depuis l'API.

Créer un webhook sortant

Vous pouvez créer un webhook directement dans Brevo pour notifier votre application externe lorsqu’un contact déclenche spécifiquement l’un des événements suivants :

Événements marketing (emails marketing et contacts)
Lorsqu'un email : Lorsqu'un contact :
  • est considéré comme spam
  • fait l'objet d'un hard bounce
  • est délivré
  • est ouvert
  • est désinscrit
  • est cliqué
  • fait l'objet d'un soft bounce
  • est ajouté à une liste
  • est mis à jour
  • est supprimé
Événements transactionnels (emails transactionnels)
Lorsqu'un email :
  • est envoyé
  • est délivré
  • est ouvert pour la première fois
  • est ouvert de manière certaine
  • est chargé par proxy
  • est cliqué 
  • fait l'objet d'un soft bounce
  • fait l'objet d'un hard bounce
  • n'est pas valide
  • fait l'objet d'une erreur
  • est différé
  • fait l'objet d'une plainte
  • est désinscrit
  • est bloqué

Pour créer un webhook :

  1. Dans Brevo, cliquez sur le menu déroulant du compte et sélectionnez Paramètres.
  2. Cliquez sur Ajouter un webhook.
  3. 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.
    webhook_ui_url_en-us.png
    💡 Bon à savoir
    L’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.
  4. Sélectionnez les événements pour lesquels vous souhaitez recevoir des notifications.
  5. Entrez une description pour le webhook.
    webhook_ui_event_description_en-us.png
  6. Cliquez sur Enregistrer.

Après avoir créé le webhook, nous vous recommandons de le tester en cliquant sur Actions > Envoyer un test ou Tester. Vous recevez une notification lorsque l’événement est déclenché.

Sécuriser vos webhooks

Pour sécuriser vos webhooks, 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.

💡 Bon à savoir
Ces plages d'adresses IP concernent les webhooks marketing, les webhooks transactionnels et les webhooks appelés directement à partir d'une automatisation.

🤔 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.

💬 Cet article vous a-t-il été utile ?

Utilisateurs qui ont trouvé cela utile : 16 sur 59