Iubenda logo
Generator starten

Anleitungen

INHALTSÜBERSICHT

Webhook-Integration mit Diensten Dritter

Das Verwalten von Einwilligungen über mehrere Tools kann herausfordernd sein – muss es aber nicht. Mit der 2-Way Sync von iubenda, die Teil der Consent Database ist, ist die Synchronisierung Ihrer Marketing-Zustimmungen über Plattformen nahtlos, in Echtzeit und vollständig konform.

Dieser Leitfaden führt Sie durch die Integration der Consent Database von iubenda mit Drittanbieterplattformen mithilfe von ausgehenden Webhooks, einschließlich Tools wie Zapier, Make und N8N. Wir werden auch fortgeschrittene Themen behandeln, wie z.B. den Umgang mit fehlgeschlagenen Versuchen, Wiederholungen und das Verständnis der Struktur der Webhook-Nutzlast.

Wie man einen ausgehenden Webhook mit Zapier integriert

1. Erstelle einen Zap:

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

2. Webhook in iubenda einrichten:

  • In iubenda, gehen Sie zum Abschnitt Outbound 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“.

    zapier Webhooks 2
  • Erstellen Sie einen neuen ausgehenden Webhook, fügen Sie die Zapier-URL ein und wählen Sie die Präferenz aus, die Sie aktualisieren möchten (z. B. Newsletter-Abonnement).
  • zapier Webhooks 2
  • Webhook speichern.

3. Testen und Veröffentlichen:

  • Ein Ereignis auslösen (z. B. ein Abonnement-Update) und den Trigger in Zapier testen.
  • 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 mit Webhooks. Wählen Sie Benutzerdefinierter Webhook und kopieren Sie die URL.
zapier Webhooks 2

2. Webhook in iubenda einrichten:

  • In iubenda, gehen Sie zum Abschnitt Outbound 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“.

    zapier Webhooks 2
  • Erstellen Sie einen neuen ausgehenden Webhook, fügen Sie die Make-URL ein und wählen Sie die Präferenz aus, die Sie verfolgen möchten (z. B. Newsletter-Updates).
  • zapier Webhooks 2
  • Webhook speichern.

3. Laufen und Automatisieren:

  • In Make, klicken Sie Redetermine data structure und lösen Sie ein Ereignis in iubenda aus (z.B. ein Update zur Newsletter-Anmeldung) und lassen Sie Make es erkennen.
  • Sie können jetzt den Webhook mit einem Dienst wie Mailchimp verknüpfen und die Updates anwenden, wie z.B. das Verwalten 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:

  • In N8N, erstellen Sie einen neuen Workflow und 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:

  • In iubenda, gehen Sie zum Abschnitt Outbound 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“.

    zapier Webhooks 2
  • Erstellen Sie einen neuen ausgehenden Webhook, fügen Sie die N8N-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

Wenn ein Webhook fehlschlägt, weil der Zielserver nicht reagiert, versucht iubenda die Anfrage mehrere Male.

  • Es versucht es 10 Mal, beginnend 2 Minuten nach dem ersten Fehler und erhöht die Wartezeit nach jedem Versuch. 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.