Richten Sie Ihre Webhooks für Ihr ganzes Team, mehrere Projekte oder einzelne Routen ein

Mit Webhooks bekommt Ihre Anwendung sofort Bescheid, wenn etwas mit Ihren E-Mails passiert. Eine Transactional E-Mail, die bounced, eine Abmeldung von Ihrem Newsletter oder eine eingehende E-Mail, die verarbeitet werden muss. Ihre Anwendung reagiert direkt, ohne dass Sie selbst nachsehen müssen, ob etwas passiert ist.

Bisher war jeder Webhook an eine Stelle gebunden. Wollten Sie dieselben Events an mehreren Stellen empfangen, legten Sie für jede Stelle einen eigenen Webhook an. Mit einer Handvoll Routen geht das noch. Aber stellen Sie sich vor, Sie führen eine Agentur mit einem Projekt pro Kunde. Dann bauen Sie dieselbe Anbindung immer wieder neu, für jeden Kunden.

Das ändern wir jetzt. Beim Anlegen eines Webhooks wählen Sie selbst den Scope: Ihr ganzes Team, ein oder mehrere Projekte oder eine oder mehrere Routen.

So funktioniert es

Webhooks haben einen eigenen Platz in der Sidebar bekommen. In der Webhook-Übersicht (wird in einem neuen Fenster geöffnet) sehen Sie ab jetzt alle Webhooks Ihres Teams an einem Ort, inklusive des Scopes. Auf einem Projekt oder einer Route selbst sehen Sie weiterhin die Webhooks, die dorthin gehören, wie bisher.

Bei jedem Webhook wählen Sie nun einen von drei Scopes:

• Team: Der Webhook empfängt Events aus all Ihren Projekten und Routen, auch aus Projekten, die Sie später anlegen.
• Projekt: Wählen Sie ein oder mehrere Projekte. Der Webhook empfängt Events aus allen Routen in diesen Projekten, auch aus Routen, die Sie später hinzufügen.
• Route: Wählen Sie eine oder mehrere Routen. Die dürfen in verschiedenen Projekten liegen.

Wie gewohnt hat jeder Webhook eine URL und ein Signing Secret. Möchten Sie den Scope nachträglich ändern und den Webhook breiter einsetzen, ist das möglich.

Sehen Sie, woher Events kommen

Empfängt Ihr Webhook Events aus mehreren Projekten oder Routen, wollen Sie wissen, wozu jedes Event gehört. Deshalb enthält jede Payload jetzt einen context mit dem Scope des Webhooks und den IDs von Team, Projekt und 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"
  }
}

        

So verarbeiten Sie alles über einen Endpoint und filtern in Ihrem eigenen Code nach Projekt oder Kunde.

Ab sofort verfügbar

Ihre bestehenden Webhooks funktionieren weiter, mit dem Scope, den sie schon hatten. Möchten Sie einen breiter einsetzen, passen Sie den Scope im Dashboard an.

Wir haben auch die Liste der Events erweitert. Mit suppression.added und suppression.removed bekommen Sie Bescheid, sobald eine Adresse auf Ihre Suppression List kommt oder von ihr entfernt wird. So weiß Ihr eigenes System immer, welche Adressen wir nicht mehr anschreiben.

Und wie Sie es von uns gewohnt sind: Auch Ihre Webhooks werden von europäischen Servern verschickt. Als europäischer E-Mail-Anbieter halten wir Ihre Event-Daten, E-Mail-Adressen eingeschlossen, innerhalb der EU.

Mehr über Webhooks, etwa das Verifizieren des Signing Secrets und alle verfügbaren Events, lesen Sie in der Webhook-Dokumentation.