Créer des webhooks pour recevoir des mises à jour en temps réel concernant vos emails et vos contacts

Si vous connaissez les métriques détaillées que Brevo propose pour les emails, vous savez à quel point il peut être difficile de s'y retrouver. Au lieu de passer au crible une multitude de données pour trouver l'information dont vous avez besoin, les webhooks vous permettent de recevoir directement les bonnes données et vous pouvez ainsi accéder aux détails importants dont vous avez besoin sans le moindre souci.

Qu'est-ce qu'un webhook ?

Les webhooks peuvent se définir comme des notifications déclenchées par des événements spécifiques. Ils s'utilisent généralement pour faciliter la communication entre plusieurs systèmes. En résumé, les webhooks fournissent un moyen simple de recevoir des alertes chaque fois qu'un événement se produit dans un autre système.

En termes plus techniques, un webhook est un rappel HTTP qui permet à plusieurs systèmes de s'interconnecter et de maintenir des actions cohérentes entre eux. Lorsqu'un événement se produit dans un système, une requête POST est envoyée à l'URL donnée en temps réel. Cette requête HTTP POST contient des informations relatives à cet événement spécifique ; par exemple l'heure à laquelle il s'est produit, le nom de l'événement et les principaux identifiants.

Comment fonctionnent les webhooks dans Brevo ?

Chez Brevo, un webhook est une URL que vous pouvez intégrer dans notre système afin de recevoir des mises à jour en temps réel sur les événements liés à l'envoi d'emails marketing et transactionnels, mais aussi la gestion de vos contacts. Avec les webhooks, vous avez la possibilité de suivre des événements spécifiques qui vous intéressent, par exemple lorsqu'un email a été ouvert ou qu'un contact a été supprimé.

Il existe plusieurs types d'événements que vous pouvez suivre . Par exemple, vous pouvez recevoir des notifications sur le statut de votre campagne marketing en cours et connaître ses performances en temps réel. Vous pouvez également savoir quand vos messages transactionnels sont envoyés, distribués ou ouverts par vos destinataires. Vous pouvez aussi être informé des modifications apportées à vos contacts.

Quels sont les événements disponibles dans Brevo ?

Tous les événements disponibles que vous pouvez suivre dans Brevo sont regroupés en deux catégories : 

Événements marketing Événements transactionnels
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é

Vous trouverez plus d'informations sur les événements marketing et les données associées dans notre documentation API.

Créer des webhooks

💡 Bon à savoir
Vous pouvez créer jusqu'à 40 webhooks pour les emails marketing et transactionnels. 

Pour nos exemples, nous nous concentrerons sur l'événement "Ouvert" de la plateforme transactionnelle. En résumé, chaque fois que nous envoyons un nouvel email transactionnel, nous recevons une notification via notre webhook indiquant que l'email a bien atteint la boîte de réception du destinataire.

À partir de Contacts, Campagnes, ou Transactionnel À l'aide d'une automatisation À l'aide de l'API
  1. Accédez à la page Webhooks :
  2. Cliquez sur Ajouter un webhook.
  3. Dans le champ URL, entrez l'URL de notification où les données de l'événement seront envoyées chaque fois que l'événement est déclenché. 
  4. Dans les champs Lorsque le message est ou Lorsqu'un contact est, sélectionnez les événements pour lesquels vous souhaitez recevoir des notifications.
  5. Dans le champ Description, saisissez une description pour le webhook.

  6. Lorsque vous avez terminé, cliquez sur Valider.
  7. Une fois votre webhook créé, nous vous recommandons de le tester. À côté du webhook que vous avez créé, cliquez sur Actions > Envoyer un test ou Test. Une fois l'événement déclenché, vous recevrez une notification sur l'URL que vous avez spécifiée pour le webhook.

Sécuriser votre webhook

Une fois que vous avez créé et testé votre webhook, nous vous recommandons de le sécuriser afin qu'il ne soit pas accessible à d'autres parties sur le Web. Pour sécuriser vos webhooks, vous devez mettre sur liste autorisée les plages IP suivantes de Brevo :

  • 185.107.232.0/24
    • Première adresse IP : 185.107.232.1
    • Dernière adresse IP : 185.107.232.254
  • 1.179.112.0/20
    • Première adresse IP : 1.179.112.1
    • Dernière adresse IP : 1.179.127.254
💡 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.

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

Utilisateurs qui ont trouvé cela utile : 4 sur 24