Iubenda logo
Generator starten

Anleitungen

INHALTSÜBERSICHT

Webhook-Integration mit Diensten Dritter

Die Verwaltung von Einwilligungen über mehrere Plattformen hinweg ist eine häufige Herausforderung für Unternehmen – aber das muss sie nicht sein. Mit der 2-Way Sync von iubenda, die Teil der Consent Database ist, können Sie den Status Ihrer Einwilligungen in all Ihren Drittanbieter-Tools in Echtzeit aktualisieren. Diese Funktion hilft Ihnen dabei, gesetzeskonform zu bleiben, genauer zu sein und die Verwaltung von Nutzerpräferenzen zu optimieren.

In diesem Leitfaden erfahren Sie, wie Sie 2-Way Sync mit der Consent Database von iubenda in Verbindung mit Tools wie Zapier, Make und N8N nutzen können. Sie lernen außerdem, wie Sie häufige Probleme wie Wiederholungen und fehlgeschlagene Versuche beheben können – einfach und leicht verständlich.

💡 Was ist 2-Way Sync mit Webhooks?

2-Way Sync stellt sicher, dass die über iubenda erfassten Einwilligungspräferenzen automatisch in verbundenen Drittanbieter-Tools aktualisiert werden. Ähnlich werden Änderungen in diesen Tools in der Consent Database von iubenda übernommen, wodurch Sie immer über die aktuellsten Daten verfügen und gesetzeskonform bleiben.

Durch Webhooks wird der Prozess nahtlos:

  • Updates in Echtzeit: In dem Moment, in dem Sie eine Einwilligungspräferenz ändern, wird eine Trigger-Aktion ausgelöst.
  • Bidirektionaler Datenfluss: Der Status Ihrer Einwilligungen in Tools wie HubSpot oder Mailchimp ist immer aktuell.

Wie man einen ausgehenden Webhook mit Zapier integriert

1. Erstelle einen Zap:

  • Melden Sie sich bei Zapier an, erstellen Sie einen neuen Zap und wählen Sie Webhooks by Zapier als App aus.
  • zapier webhooks
  • Wählen Sie Catch Hook als Trigger-Ereignis und kopieren Sie die Webhook-URL, die Zapier bereitstellt.
zapier Webhooks 2

2. Webhook in iubenda einrichten:

  • Zurück in iubenda, gehen Sie zum Abschnitt Consent Database Webhooks. (Vom iubenda Dashboard, wählen Sie das Projekt aus und klicken Sie auf das Einstellungssymbol, Öffnen Sie die Consent Database Webhooks: Klicken Sie im Seitenmenü auf „Consent Database Webhooks“)

  • Animation, die zeigt, wie man auf den Webhooks-Bereich in Zapier zugreift
  • Erstellen Sie einen neuen ausgehenden Webhook, fügen Sie die von Zapier bereitgestellte URL ein und wählen Sie die Präferenz aus, die Sie synchronisieren möchten (z. B. Newsletter-Abonnement).
  • zapier Webhooks 2
  • Webhook speichern.

3. Testen und Veröffentlichen:

  • Ein Ereignis in iubenda auslösen (z. B. ein Abonnement-Update).
  • Testen Sie den Webhook in Zapier und verbinden Sie ihn mit dem Drittanbieterdienst, den Sie synchronisieren möchten (z. B. Mailchimp).
  • zapier Webhooks 2
  • [Optional] Filter oder Pfade definieren:
    • Wenn Sie mehrere Werte über Webhooks senden (z. B. alle Newsletter-Präferenzen), richten Sie Filter oder Pfade in Zapier ein, um nur mit bestimmten Werten fortzufahren, z. B. nur wenn die Präferenz auf “wahr” gesetzt ist.
    • Fügen Sie den Dienst hinzu, den Sie verbinden möchten (z. B. Mailchimp) und geben Sie die Änderungen an, die Sie anwenden möchten, z. B. das Aktualisieren des Status des Abonnenten basierend auf dem E-Mail-Feld im Webhook.
  • zapier Webhooks 2
  • Sobald alles funktioniert, veröffentlichen Sie den Zap.
  • zapier Webhooks 2

💡 Hinweis: Verwenden Sie Zap history, um sicherzustellen, dass alles reibungslos läuft.

zapier Webhooks 2

Wie man einen ausgehenden Webhook mit Make integriert

1. Erstellen Sie ein Szenario:

  • Melden Sie sich bei Make an und erstellen Sie ein neues Szenario.
  • Klicken Sie auf Webhooks, wählen Sie Custom Webhook und kopieren Sie die bereitgestellte URL.
zapier Webhooks 2

2. Webhook in iubenda einrichten:

  • Zurück in iubenda, gehen Sie zum Abschnitt Consent Database Webhooks. (Vom iubenda Dashboard, wählen Sie das Projekt aus und klicken Sie auf das Einstellungssymbol, Öffnen Sie die Consent Database Webhooks: Klicken Sie im Seitenmenü auf „Consent Database Webhooks“)

  • Animation, die zeigt, wie man auf den Webhooks-Bereich in Zapier zugreift
  • Erstellen Sie einen neuen ausgehenden Webhook, fügen Sie die von Make bereitgestellte URL ein und wählen Sie die Präferenz aus, die Sie tracken möchten (z. B. Newsletter-Updates).
  • zapier Webhooks 2
  • Webhook speichern.

3. Laufen und Automatisieren:

  • Klicken Sie in Make auf Redetermine data structure und lösen Sie ein Ereignis in iubenda aus (z. B. ein Update eines Newsletter-Abonnements).
  • Make erkennt die Datenstruktur und verbindet den Webhook mit einem Drittanbieter-Tool (z. B. HubSpot).
  • Sie können jetzt den Webhook mit einem Dienst wie Mailchimp oder HubSpot verknüpfen und die Updates anwenden, z. B. die Verwaltung von Abonnenten basierend auf ihrer E-Mail.
  • Sobald bestätigt, wird das System automatisch ausgeführt.
  • [Optional] Filter hinzufügen:
    • Wenn Sie mehrere Werte senden, setzen Sie Filter in Make, um nur auszulösen, wenn bestimmte Werte gesendet werden.
zapier Webhooks 2

💡 Hinweis: Überprüfen Sie das Dashboard, um die Integration zu überwachen.

zapier Webhooks 2

Wie man einen ausgehenden Webhook mit N8N integriert

1. Erstellen Sie einen Workflow:

  • Öffnen Sie N8N und erstellen Sie einen neuen Workflow.
  • Fügen Sie einen Webhook-Knoten hinzu, setzen Sie die Methode auf POST und kopieren Sie die Webhook-URL.
zapier Webhooks 2

2. Webhook in iubenda einrichten:

  • Zurück in iubenda, gehen Sie zum Abschnitt Consent Database Webhooks. (Vom iubenda Dashboard, wählen Sie das Projekt aus und klicken Sie auf das Einstellungssymbol, Öffnen Sie die Consent Database Webhooks: Klicken Sie im Seitenmenü auf „Consent Database Webhooks“)

  • Animation, die zeigt, wie man auf den Webhooks-Bereich in Zapier zugreift
  • Erstellen Sie einen neuen ausgehenden Webhook, fügen Sie die von N8N bereitgestellte URL ein und wählen Sie die Präferenz aus, die Sie verfolgen möchten.
  • zapier Webhooks 2
  • Webhook speichern.

3. Testen und Live gehen:

  • In N8N, hören Sie auf das Testereignis (z. B. ein Abonnement-Update) und lassen Sie N8N die Datenstruktur bestätigen.
  • [Optional] Filter oder Pfade hinzufügen:
    • Wenn Sie mehrere Werte senden, können Sie Filter einrichten, um nur bestimmte Werte zu verarbeiten oder verschiedene Pfade für verschiedene Ergebnisse zu erstellen.
    • Verbinden Sie jetzt den Webhook mit einer App wie Mailchimp und wenden Sie alle Änderungen an, z. B. das Erstellen eines neuen Kontakts.
    • zapier Webhooks 2
    • Speichern Sie Ihren Workflow und aktivieren Sie ihn. Von nun an wird jedes Mal, wenn ein Abonnent zur Consent Database hinzugefügt wird, automatisch mit Mailchimp synchronisiert.

💡 Hinweis: Verwenden Sie die Ausführungstab in N8N, um sicherzustellen, dass alles ordnungsgemäß funktioniert.

zapier Webhooks 2

Erweitert: Was zu tun ist, wenn ein Webhook fehlschlägt

Manchmal kann ein Webhook aufgrund von Problemen mit dem Zielserver fehlschlagen. In solchen Fällen versucht iubenda automatisch, die Anfrage bis zu 10 Mal zu wiederholen, und folgt diesem Zeitplan:

  1. 2 Minuten nach dem ersten Fehler.
  2. Zunehmende Intervalle (5 Minuten, 10 Minuten, bis zu 3 Stunden).
  3. Nach 10 fehlgeschlagenen Versuchen wird der Webhook als fehlgeschlagen und deaktiviert markiert.

Hier ist der Wiederholungszeitplan:

  • Erster Versuch Nach 2 Minuten
  • Zweiter Versuch Nach weiteren 5 Minuten
  • Dritter Versuch Nach weiteren 10 Minuten
  • Vierter Versuch Nach weiteren 20 Minuten
  • Fünfter Versuch Nach weiteren 45 Minuten
  • Sechster Versuch Nach 1 Stunde
  • Siebenter Versuch Nach 1,5 Stunden
  • Der achte Versuch Nach 2 Stunden
  • Neunter Versuch Nach 2,5 Stunden
  • Zehnter Versuch Nach 3 Stunden
  • Nach 10 fehlgeschlagenen Versuchen wird der Webhook als failed markiert und nicht erneut versucht.

Leistungsschalter

Wenn ein Webhook 10 Mal hintereinander fehlschlägt, wird er automatisch deaktiviert. Sie erhalten eine E-Mail, und sie wird in Ihren Webhook-Einstellungen als deaktiviert markiert.

Webhook-Payload-Beispiel

Hier ist ein Beispiel für die Daten, die iubenda in einem Webhook sendet:

{
"subject": {
"id": "9b05c70c5c78a31aeaf13f8f27c1f890",
"email": "subject@email.com"
},
"consent_preferences": {
"newsletter": "false"
},
"changes": {
"newsletter": "false"
}
}
  • subject: Die Nutzer-ID und die E-Mail.
  • consent_preferences: Die aktualisierten Einwilligungspräferenzen, wie das Abonnieren oder Abbestellen eines Newsletters.
  • changes: Änderungen im Vergleich zum vorherigen Einwilligungsprotokoll.