Configurez vos webhooks pour toute votre équipe, plusieurs projets ou des routes individuelles

Avec les webhooks, votre application est prévenue dès qu'il se passe quelque chose avec vos e-mails. Un e-mail transactionnel qui bounce, une désinscription de votre newsletter ou un e-mail entrant à traiter. Votre application réagit tout de suite, sans devoir vérifier elle-même s'il s'est passé quelque chose.

Jusqu'ici, chaque webhook était rattaché à un seul endroit. Pour recevoir les mêmes events à plusieurs endroits, vous créiez un webhook séparé pour chacun. Avec quelques routes, ça reste gérable. Mais imaginez que vous gérez une agence avec un projet par client. Vous refaites alors la même intégration encore et encore, pour chaque client.

C'est ce qui change aujourd'hui. À la création d'un webhook, vous choisissez vous-même le scope : toute votre équipe, un ou plusieurs projets, ou une ou plusieurs routes.

Comment ça marche

Les webhooks ont désormais leur propre place dans la sidebar. La vue d'ensemble des webhooks (ouvre dans une nouvelle fenêtre) affiche tous les webhooks de votre équipe au même endroit, avec le scope de chacun. Sur un projet ou une route, vous voyez toujours les webhooks qui s'y rapportent, comme avant.

Pour chaque webhook, vous choisissez maintenant un des trois scopes :

• Équipe : le webhook reçoit les events de tous vos projets et routes, y compris les projets que vous créez plus tard.
• Projet : choisissez un ou plusieurs projets. Le webhook reçoit les events de toutes les routes de ces projets, y compris celles que vous ajoutez plus tard.
• Route : choisissez une ou plusieurs routes. Elles peuvent appartenir à des projets différents.

Comme d'habitude, chaque webhook a une URL et un signing secret. Vous voulez changer le scope après la création et élargir le webhook ? C'est possible.

Sachez d'où viennent les events

Quand votre webhook reçoit des events de plusieurs projets ou routes, vous voulez savoir d'où vient chacun. C'est pourquoi chaque payload contient maintenant un context avec le scope du webhook et les identifiants de votre équipe, projet et route :

          {
  "context": {
    "scope": "route",
    "team_id": "9f4e3d2c-1b0a-4987-9654-3210fedcba98",
    "project_id": "7d6c5b4a-3210-4987-9654-fedcba987654",
    "route_id": "1a2b3c4d-5678-4987-9654-abcdef123456"
  }
}

        

Vous traitez ainsi tout sur un seul endpoint et filtrez par projet ou par client dans votre propre code.

Disponible dès maintenant

Vos webhooks existants continuent de fonctionner, avec le scope qu'ils avaient déjà. Vous voulez en élargir un ? Modifiez son scope dans le dashboard.

Nous avons aussi étendu la liste des events. Avec suppression.added et suppression.removed, vous êtes prévenu dès qu'une adresse arrive sur votre suppression list ou en sort. Votre propre système sait ainsi toujours quelles adresses nous ne contactons plus.

Et comme vous en avez l'habitude avec nous : vos webhooks aussi partent de serveurs européens. En tant que fournisseur d'e-mail européen, nous gardons vos données d'events, adresses e-mail comprises, au sein de l'UE.

Pour en savoir plus sur les webhooks, comme la vérification du signing secret et tous les events disponibles, consultez la documentation des webhooks.