Suche

Erstellen von eingehenden Webhooks, um Echtzeitdaten von einer anderen App in Brevo zu erhalten

clickable_banner-pricing_4_en-us.png

Eingehende Webhooks ermöglichen es dir, in Brevo Echtzeitdaten von einer externen App zu empfangen. Jedes Mal, wenn ein Ereignis in deiner externen App eintritt, erhält Brevo einen Webhook mit den Details des Ereignisses. Du hast dann folgende Möglichkeiten:

  • Triggere ein benutzerdefiniertes Ereignis in Brevo; und/oder
  • Erstelle oder aktualisiere automatisch einen Kontakt auf der Grundlage der empfangenen Daten.

Gut zu wissen

  • Die eingehenden Webhooks werden derzeit schrittweise eingeführt und sind möglicherweise noch nicht für alle Konten verfügbar.
  • Du kannst bis zu 20 eingehende Webhooks in deinem Brevo-Konto erstellen. Um einen neuen Webhook über dieses Limit hinaus hinzuzufügen, lösche einen bestehenden.
  • Jede Webhook-URL kann bis zu 20 Ereignisse pro Sekunde verarbeiten.
  • Derzeit kannst du nur Daten aus der ersten Hierarchieebene des JSON-Payloads abrufen. Das bedeutet, dass du direkt auf Arrays und Objekte der obersten Ebene zugreifen kannst, aber du kannst keine Daten aus verschachtelten Arrays oder tieferen Ebenen abrufen.
  • Wenn du ausgehende Webhooks erstellen möchtest, um Echtzeitdaten von Brevo an eine externe App zu versenden, lies unseren Artikel Neue Webhooks – Erstellen von ausgehenden Webhooks, um Echtzeitdaten von Brevo an eine externe App zu versenden.

Schritt 1: Erstelle einen eingehenden Webhook in Brevo

Zunächst musst du einen eingehenden Webhook in Brevo erstellen.

  1. Klicke auf das Konto-Dropdown-Menü und wähle Integrations (Integrationen).
  2. Öffne die Registerkarte Webhooks.
  3. Klicke auf Add webhook (Webhook hinzufügen).
    webhook_outbound_create_en-us.png
  4. Wähle Inbound Webhook (Eingehender Webhook).
  5. Klicke auf Add webhook (Webhook hinzufügen).
    webhook_inbound_create_en-us.png

Schritt 2: Richte den eingehenden Webhook in Brevo ein

Anschließend richtest du den eingehenden Webhook in Brevo ein.

  1. Gib einen Namen für den Webhook ein.
    webhook_inbound_name_en-us.png
  2. Klicke auf Continue (Weiter).
  3. Wähle die HTTP-Methode, die du für diesen Webhook verwenden willst (POST, GET, PUT oder PATCH).
  4. Kopiere die von Brevo generierte Webhook-URL. Mit dieser Callback-URL wird deiner externen App mitgeteilt, wohin der eingehende Webhook versendet werden soll, wenn ein Ereignis eintritt.
    webhook_inbound_copy-url_en-us.png
  5. Füge die Webhook-URL in deine externe App ein. Normalerweise geschieht dies über eine Konfigurationsseite für Webhooks, einen Bereich für die Automatisierung oder über eine API-Integration.
    💡 Gut zu wissen
    Wenn du dir nicht sicher bist, wo du die Webhook-URL einfügen sollst, überprüfe das Hilfecenter deiner externen App oder wende dich an deren Support-Team.
  6. (Optional) Um eine zusätzliche Sicherheitsebene hinzuzufügen, oder wenn deine externe App dies erfordert, solltest du Folgendes tun:
    1. Aktiviere die Option Require authentication (Authentifizierung verlangen).
    2. Kopiere den von Brevo generierten Token.
      webhook_inbound_token_en-us.png
      💡 Gut zu wissen
      Wenn dein Token kompromittiert ist, kannst du ihn neu generieren, indem du auf das Symbol 🔄 Aktualisieren klickst und ihn in deiner externen App aktualisierst.
    3. Füge das Token in deine externe App ein.
  7. Beende die Einrichtung des eingehenden Webhooks in deiner externen App. Du könntest aufgefordert werden, eine Option auszuwählen:
    • Das Ereignis, das den Webhook auslösen wird.
    • Die Daten, die in der Nutzlast enthalten sein sollen.

Schritt 3: Versende eine Testanfrage und wähle die zu synchronisierende Nutzlast

❗️ Wichtig

Vergewissere dich, dass sich die Parameter, die du synchronisieren willst, in den obersten Arrays und Objekten der JSON-Nutzdaten befinden, da auf verschachtelte Daten oder tiefere Ebenen vorerst nicht zugegriffen werden kann.

Teste den eingehenden Webhook und bestätige den Empfang der Ereignisdaten.

  1. Versende eine Testanfrage von deiner externen App an Brevo. 
  2. Überprüfe die empfangenen Ereignisdaten, um sicherzustellen, dass sie alle Parameter enthalten, die du synchronisieren möchtest. Wenn Informationen fehlen, versende weitere Testanfragen, bis die richtige Nutzlast empfangen wird.
    webhook_inbound_payload_en-us.png
  3. (Optional) Wenn mehrere Testanfragen versendet wurden:
    1. Klicke auf 🔄 Reload (Neu laden).
    2. Benutze das Dropdown-Menü, um die gewünschte Nutzlast aus den letzten 10 empfangenen Nutzlasten auszuwählen.
      webhook_inbound_reload_en-us.png
  4. Klicke auf Continue (Weiter).

Schritt 4: Konfiguriere die Aktion, die durch den eingehenden Webhook ausgelöst wird

Lege fest, welche Aktion in Brevo ausgelöst werden soll, wenn der Webhook empfangen wird. Dabei werden die Payload-Schlüssel (die im eingehenden Webhook empfangenen Ereignisdaten) auf Brevo-Attribute abgebildet, um sicherzustellen, dass die eingehenden Daten richtig formatiert sind und die richtige Aktion auslösen.

Du kannst aus zwei verfügbaren Optionen auswählen:

  • Option 1: Erstelle ein Ereignis
    Verfolge externe Aktionen in Brevo, indem du ein eigenes Ereignis erstellst.
  • Option 2: Erstelle oder aktualisiere einen Kontakt
    Füge automatisch Kontaktdaten in Brevo hinzu oder aktualisiere sie.
Option 1: Ein Ereignis erstellen Option 2: Einen Kontakt erstellen oder aktualisieren

Du kannst ein benutzerdefiniertes Ereignis in Brevo auslösen, wenn der eingehende Webhook in deiner externen App ausgelöst wird. Brevo verknüpft das Ereignis anhand der im Webhook enthaltenen Kennung (z. B. E-Mail-Adresse, externe ID usw.) mit einem bestimmten Kontakt. Wenn kein passender Kontakt gefunden wird, erstellt Brevo automatisch einen neuen Kontakt unter Verwendung der angegebenen Kennung. 

  1. Klicke auf + Add action (+ Aktion hinzufügen).
  2. Wähle Create event (Ereignis erstellen) aus.

  3. Ordne die Brevo-Ereignisattribute mit der Variablenauswahl {} deinen Payload-Schlüsseln zu oder gib manuell einen festen Wert ein, der jedes Mal angewendet wird, wenn der Webhook empfangen wird. Es gibt drei obligatorische Attribute für Brevo-Ereignisse:

    • event_name: Name des Ereignisses.
    • identifiers: Kontaktkennungen, die verwendet werden, um das Ereignis mit dem entsprechenden Kontakt in Brevo zu verknüpfen (z. B. E-Mail, externe ID).
    • event_date: Datum des Ereignisses.
  4. Markiere Brevo-Ereignisattribute als erforderlich oder optional:
    •  Required (Erforderlich): Wenn das Attribut in der Nutzlast fehlt, werden die Webhook-Aktionen nicht auf Brevo abgebildet.
    • Optional: Wenn das Attribut in der Nutzlast fehlt, werden die Webhook-Aktionen trotzdem auf Brevo abgebildet, aber der fehlende Wert wird auf „null“ gesetzt.
      webhook_inbound_map-event-attribute_en-us.png
  5. (Optional) Klicke auf + Add event attribute (+ Ereignisattribut hinzufügen), um weitere Brevo Ereignisattribute zuzuordnen.
    webhook_inbound_add-event-attribute_en-us.png
  6. (Optional) Klicke auf + Add action (+ Aktion hinzufügen), um eine weitere Aktion zu konfigurieren, die ausgelöst wird, wenn der Webhook empfangen wird.

  7. Klicke auf Activate webhook (Webhook aktivieren), wenn du fertig bist.

  8. Klicke erneut auf Activate webhook (Webhook aktivieren), um zu bestätigen.

Sobald der eingehende Webhook aktiviert ist, versendet er jedes Mal, wenn er getriggert wird, Daten von deiner externen App an Brevo. Mit den empfangenen Daten kannst du dann verschiedene Aktionen durchführen, wie z. B.:

  • Segmentierung von Kontakten anhand von Ereignisdaten.
  • Triggern von Automatisierungen durch benutzerdefinierte Ereignisse.
  • Personalisieren von E-Mails, SMS oder anderen Nachrichten.

Überprüfung der Logs eines eingehenden Webhooks zur Fehlerbehebung

Jedes Mal, wenn ein eingehender Webhook getriggert wird, versendet er Daten von deiner externen App an Brevo, wo die Webhook-Aktionen verarbeitet werden. Du kannst die Logs eines eingehenden Webhooks überprüfen, um festzustellen, ob die Aktionen erfolgreich ausgeführt wurden und um mögliche Probleme bei der Fehlerbehebung zu identifizieren.

  1. Klicke auf das Konto-Dropdown-Menü und wähle Integrations (Integrationen).
  2. Gehe auf die Registerkarte Webhooks.
  3. Wähle die Option Inbound webhook (Eingehender Webhook) aus. Hier findest du eine Übersicht über die in den letzten 24 Stunden verarbeiteten Aktionen und deren Status für jeden eingehenden Webhook:
    • Mapped: Die Aktion wurde erfolgreich bearbeitet.
    • Not mapped: Es ist ein Fehler aufgetreten, und die Aktion wurde nicht bearbeitet.
      webhook_inbound_mapped-actions_en-us.png
  4. Klicke auf den Namen des eingehenden Webhooks, um seine Logs aufzurufen.
  5. Auf der Registerkarte Logs überprüfst du die Logs des eingehenden Webhooks:
    webhook_inbound_logs-overview_en-us.gif
    1. Filter by status (Filtern nach Status): Alle Aktionen, nur zugeordnete Aktionen oder nicht zugeordnete Aktionen anzeigen.
    2. Refresh logs (Logs aktualisieren): Die neuesten Daten in Echtzeit.
    3. View inbound webhook calls (Eingehende Webhook-Aufrufe anzeigen): Überprüfen des Zeitstempels und der verarbeiteten Nutzdaten für jeden Webhook-Aufruf.
    4. Überprüfung der bearbeiteten Aktionen und Attribute: Stellt fest, welche Aktionen Brevo nach dem Empfang eines eingehenden Webhooks durchgeführt hat, und überprüfe die Daten, die für jede Aktion übermittelt wurden. Wenn ein Fehler auftritt, wird der erwartete Schlüsseltyp mit dem empfangenen Wert verglichen.

Eingehende Webhooks deaktivieren

Wenn du vorübergehend keine Daten von deiner externen App erhalten möchtest, kannst du den eingehenden Webhook deaktivieren.

  1. Klicke auf das Konto-Dropdown-Menü und wähle Integrations (Integrationen).
  2. Öffne die Registerkarte Webhooks.
  3. Wähle die Option Inbound webhook (Eingehender Webhook) aus.
  4. Klicke auf den eingehenden Webhook, den du deaktivieren möchtest.
    webhook_inbound_deactivate_en-us.png

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

Einen eingehenden Webhook löschen

❗️ Wichtig
Diese Aktion ist unumkehrbar. Einmal gelöscht, können der eingehende Webhook und die mit ihm verknüpfte Callback-URL nicht wiederhergestellt werden.

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

  1. Klicke auf das Konto-Dropdown-Menü und wähle Integrations (Integrationen).
  2. Öffne die Registerkarte Webhooks.
  3. Wähle die Option Inbound webhook (Eingehender Webhook) aus.
  4. Klicke neben dem eingehenden Webhook, den du löschen möchtest, auf das Papierkorbsymbol.
    webhook_inbound_delete_en-us.png
  5. Klicke auf Delete webhook (Webhook löschen), um zu bestätigen.

Der eingehende Webhook und die mit ihm verknüpfte Callback-URL wurden dauerhaft gelöscht.

⏭️ Nächste Schritte

🤔 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.

💬 War dieser Beitrag hilfreich?

2 von 2 fanden dies hilfreich