Mit ausgehenden Webhooks kannst du Echtzeitdaten von Brevo an eine externe Anwendung versenden. Wenn ein bestimmtes Ereignis in Brevo eintritt, erhält deine externe App eine Benachrichtigung mit den Ereignisdetails.

Du kannst ausgehende Webhooks für Ereignisse im Zusammenhang mit den folgenden Brevo-Funktionen erstellen:

Gut zu wissen

• Du kannst bis zu 40 ausgehende Webhooks pro Brevo-Konto erstellen. Sobald du dieses Limit erreichst, lösche einen bestehenden Webhook, bevor du einen neuen erstellst.
• Ausgehende Webhooks können auch über eine Automatisierung oder die API erstellt werden.
• Um eingehende Webhooks zu erstellen, damit du Echtzeitdaten von einer anderen App in Brevo empfangen kannst, überprüfe unseren Artikel Eingehende Webhooks erstellen, um Echtzeitdaten in Brevo zu empfangen.

Erste Schritte

Stelle sicher, dass du von deiner externen App Folgendes abrufst:

• Die URL des Servers oder Endpunkts, an den du den ausgehenden Webhook versenden willst
• (Optional) Die Authentifizierungsmethode und die erforderlichen Anmeldedaten
• Jeder erforderliche Name und Wert des Headers

Wenn du dir nicht sicher bist, wo du diese Informationen findest, überprüfe das Hilfecenter deiner externen App oder wende dich an deren Support-Team.

Schritt 1: Erstellen eines ausgehenden Webhooks in Brevo

So erstellst du einen ausgehenden Webhook in Brevo:

1. In Brevo klickst du auf deinen Kontonamen und wählst Integrations > Webhooks.
2. Klicke auf Add webhook (Webhook hinzufügen).
   
3. Wähle Outbound webhook (Ausgehender Webhook) aus.
4. Klicke auf Add webhook (Webhook hinzufügen).
   

Schritt 2: Einrichtung des ausgehenden Webhooks

Lege dann den Namen, die URL und die Authentifizierungsmethode für den ausgehenden Webhook fest.

1. Gib einen Namen für den Webhook ein.
2. Klicke auf Continue (Weiter).
3. Gib die URL des Servers oder Endpunkts ein, an den du deine Ereignisse versenden möchtest. Dadurch wird Brevo mitgeteilt, wohin der ausgehende Webhook versendet werden soll, wenn ein Ereignis eintritt.
   
4. (Optional) Standardmäßig ist No authentication (Keine Authentifizierung) als Authentifizierungsmethode ausgewählt. Um eine zusätzliche Sicherheitsebene zu schaffen, oder wenn die externe App, an die du den Webhook versendest, dies erfordert, kannst du eine der folgenden Optionen wählen:
   • Grundlegende Authentifizierung (Benutzername und Passwort), oder
   • Token-Authentifizierung
     
5. (Optional) Um deinem ausgehenden Webhook einen Header hinzuzufügen, gehst du wie folgt vor:
   1. Klicke auf + Add an object (+ Ein Objekt hinzufügen).
   2. Gib den Namen und den Wert des Headers ein.
      
6. Wähle deine Strategie für das Versenden von Webhooks aus:
   • Send one at a time (Einzeln versenden)
     Versende Ereignisse einzeln und in Echtzeit.
   • Send by batch (in Batch versenden)
     Versende Ereignisse in Batches von bis zu 500. Dies wird empfohlen, wenn du niedrigere Preisgrenzen hast, da es die Anzahl der Anfragen reduzieren kann.
7. Klicke auf Continue (Weiter).

Schritt 3: Auswahl der Ereignisse und Versenden von Testanfragen

Anschließend wählst du die Ereignisse aus, für die du den ausgehenden Webhook empfangen und Testanfragen an deine externe App versenden möchtest.

1. Wähle die Ereigniskategorie aus, für die du einen ausgehenden Webhook erstellen möchtest (z. B. Transaktions-E-Mails, Deals, Formulare usw.).
   
   💡 Gut zu wissen

   Kontakt-Ereignisse befinden sich in der Ereigniskategorie Marketing-E-Mails.
2. Standardmäßig sind alle Ereignisse innerhalb der ausgewählten Kategorie aktiviert. Bei Bedarf kannst du bestimmte Ereignisse deaktivieren, indem du sie ausschaltest.
   
3. (Optional) So versendest du Testanfragen für die Ereignisse:
   1. Klicke auf das Drei-Punkte-Symbol neben einem Ereignis und wähle Send test request (Testanfrage versenden).
      
   2. Überprüfe in deiner externen App, ob du den ausgehenden Webhook erhalten hast.
4. Klicke auf Activate webhook (Webhook aktivieren), wenn du fertig bist.

Deinen ausgehenden Webhook schützen

Um deine ausgehenden Webhooks zu schützen, musst du einige der IP-Ranges von Brevo auf eine Whitelist setzen. So wird sichergestellt, dass nur autorisierte Anfragen den Webhook auslösen können. 

➡️ Weitere Informationen findest du in unserem Artikel Brevo IP-Range: Liste der öffentlich zugänglichen Dienste.

Webhook-Zustellung überwachen und Warnmeldungen konfigurieren

Überwache die Zustellung deiner ausgehenden Webhook-Events und konfiguriere Warnmeldungen, um benachrichtigt zu werden, wenn Probleme auftreten.

Deine Webhook-Statistiken überprüfen

Mit dem Monitoring-Dashboard kannst du den Lieferstatus deiner ausgehenden Webhook-Events verfolgen. Dadurch kannst du Lieferprobleme schnell erkennen.

So überprüfst du deine Statistiken für ausgehende Webhook-Events:

1. In Brevo klickst du auf deinen Kontonamen und wählst Integrations > Webhooks.
2. Klicke auf der Registerkarte Outbound webhooks (Ausgehende Webhooks) auf den ausgehenden Webhook, den du überwachen möchtest.

3. Überprüfe unter Statistics (Statistik) den Lieferstatus deiner ausgehenden Webhook-Events:

   📨 Zustellstatus📊 Balkendiagramm

   

   Sieh dir die Anzahl der ausgehenden Webhook-Events der letzten 24 Stunden in folgenden drei Lieferzuständen an:

   • ❌ Failed (Fehlgeschlagen): Die Anzahl der eindeutigen ausgehenden Webhook-Events, die nach 24 Stunden mit Wiederholungsversuchen nicht zugestellt werden konnten und verworfen wurden.
   • ⚠️ Retries (Erneut versucht): Die Anzahl der eindeutigen ausgehenden Webhook-Events , die in den letzten 24 Stunden erneut versucht wurden. Weitere Informationen über den Wiederholungsmechanismus findest du in unserer speziellen API-Dokumentation.
   • ✅ Delivered (Zugestellt): Die Anzahl der einzigartigen ausgehenden Webhook-Events, die in den letzten 24 Stunden erfolgreich übermittelt wurden.

   

   Das Balkendiagramm für 24 Stunden zeigt die Anzahl der ausgehenden Webhook-Ereignisse in jedem Status mit einer stündlichen Aufschlüsselung. Du kannst mit dem Mauszeiger über einen Balken fahren, um die genaue Anzahl der ausgehenden Webhook-Events zu sehen, die in dieser Stunde wiederholt wurden, zugestellt wurden oder fehlgeschlagen sind.

Webhook-Benachrichtigungen konfigurieren

Richte E-Mail-Benachrichtigungen ein, um benachrichtigt zu werden, wenn die Zustellung von ausgehenden Webhook-Events einen bestimmten Schwellenwert erreicht. Wenn ein Schwellenwert erreicht wird, wird eine Benachrichtigung an die Standard-E-Mail-Adresse deines Kontos geschickt, maximal eine pro Stunde.

So konfigurierst du Webhook-Benachrichtigungen:

1. Aktiviere unter Alert configuration (Konfiguration von Benachrichtigungen) die Benachrichtigungen, die du erhalten möchtest:
   • Retry alert (Benachrichtigung bei Wiederholungen)
     Lege einen Schwellenwert fest, um eine Benachrichtigung zu erhalten, wenn die Anzahl der wiederholten ausgehenden Webhook- Events diesen Wert erreicht. Der Grenzwert liegt bei 50.
   • Fail alert (Benachrichtigung für Fehlschläge)
     Lege einen Grenzwert fest, um eine Benachrichtigung zu erhalten, wenn die Anzahl der fehlgeschlagenen ausgehenden Webhook- Events diesen Wert erreicht. Der Grenzwert liegt bei 50.
     
2. Klicke auf Save (Speichern).

Einen ausgehenden Webhook deaktivieren

Wenn du vorübergehend keine Daten von Brevo an deine externe App senden möchtest, kannst du den ausgehenden Webhook deaktivieren.

1. In Brevo klickst du auf das Dropdown-Menü des Kontos und wählst Integrations (Integrationen).
2. Gehe zur Registerkarte Webhooks.
3. Wähle die Option Outbound Webhook (Ausgehender Webhook).
4. Klicke auf den ausgehenden Webhook, den du deaktivieren möchtest.
    

Der ausgehende Webhook ist jetzt deaktiviert (graue Schaltfläche). Du kannst ihn jederzeit wieder aktivieren, indem du ihn einschaltest.

Einen ausgehenden Webhook löschen

Wenn du einen ausgehenden Webhook nicht mehr benötigst, kannst du ihn dauerhaft löschen.

1. Klicke in Brevo auf deinen Kontonamen und wähle Integrations (Integrationen).
2. Gehe zur Registerkarte Webhooks.
3. Wähle die Option Outbound Webhook (Ausgehender Webhook).
4. Klicke neben dem ausgehenden Webhook, den du löschen möchtest, auf das Papierkorbsymbol 🗑️.
   
5. Klicke auf Delete webhook (Webhook löschen), um zu bestätigen.

Der ausgehende Webhook wurde dauerhaft gelöscht.

🤔 Sie haben eine Frage?

Wenden Sie sich bei Fragen an unser Support-Team: Erstellen Sie einfach ein Ticket über Ihr Konto. Wenn Sie noch kein Konto haben, können Sie uns hier kontaktieren.

Wenn Sie Unterstützung bei einem Projekt mit Brevo suchen, können wir Sie mit der richtigen zertifizierten Brevo-Partneragentur verbinden.