Stel je webhooks voortaan in voor je hele team, meerdere projecten of routes

Met webhooks krijgt je applicatie direct bericht als er iets met je e-mail gebeurt. Een transactional e-mail die bounced, een afmelding op je nieuwsbrief, of een inkomende e-mail die verwerkt moet worden. Zo reageert je applicatie meteen, zonder dat je zelf hoeft te controleren of er iets is gebeurd.

Tot nu toe koppelde je elke webhook aan één plek. Wilde je dezelfde events op meerdere plekken ontvangen, dan maakte je telkens een aparte webhook aan. Met een handvol routes is dat prima te doen. Maar stel, je runt een webbureau met een project per klant. Dan bouw je dezelfde koppeling telkens opnieuw, voor elke klant.

Daar brengen we nu verandering in. Bij het aanmaken van een webhook kies je zelf de scope: je hele team, een of meer projecten, of een of meer routes.

Hoe werkt het

Webhooks hebben een eigen plek in de sidebar gekregen. In het webhook-overzicht (opent in een nieuw venster) zie je voortaan alle webhooks binnen je team op één plek, inclusief de scope van elke webhook. Op een project of route zelf zie je nog steeds de webhooks die daarbij horen, net als voorheen.

Bij elke webhook kies je nu een van drie scopes:

• Team: de webhook ontvangt events van al je projecten en routes, ook van projecten die je later aanmaakt.
• Project: kies een of meer projecten. De webhook ontvangt events van alle routes in die projecten, ook van routes die je later toevoegt.
• Route: kies een of meer routes. Die mogen in verschillende projecten zitten.

Zoals gewend heeft elke webhook één URL en één signing secret. Wil je na het aanmaken de scope veranderen en de webhook breder inzetten, dan is dit mogelijk.

Zie waar events vandaan komen

Ontvangt je webhook events uit meerdere projecten of routes, dan wil je weten waar elk event bij hoort. Daarom bevat elke payload nu een context met de scope van de webhook en de bijbehorende ID's van je team, project en 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"
  }
}

        

Zo verwerk je alles op één endpoint en filter je in je eigen code per project of klant.

Nu beschikbaar

Je bestaande webhooks blijven gewoon werken, met de scope die ze al hadden. Wil je er een breder inzetten, pas dan de scope aan in het dashboard.

We hebben de lijst met events ook uitgebreid. Met suppression.added en suppression.removed krijg je bericht zodra een adres op je suppression list komt of eraf gaat. Zo weet je eigen systeem altijd welke adressen we niet meer aanschrijven.

En zoals je van ons gewend bent: ook je webhooks worden verstuurd vanaf Europese servers. Als Europese e-mailprovider houden we je event-data, inclusief e-mailadressen, binnen de EU.

Meer weten over webhooks, zoals het verifiëren van de signing secret en alle beschikbare events? Lees de webhook-documentatie.