Integratie van webhooks met diensten van derden

Het beheren van toestemming op meerdere platforms is een veelvoorkomende uitdaging voor bedrijven, maar zo moeilijk hoeft het niet te zijn. Met iubenda’s 2-Way Sync, onderdeel van de Consent Database, kun je toestemmingsstatussen in realtime up-to-date houden in al je externe tools. Met deze functie blijf je compliant, verbeter je de nauwkeurigheid en stroomlijn je het beheer van gebruikersvoorkeuren.

Deze gids laat je zien hoe je 2-Way Sync kunt instellen vanuit iubenda’s Consent Database met tools als Zapier, Make en N8N. Je komt ook te weten hoe je omgaat met veelvoorkomende problemen zoals (mislukte) pogingen, allemaal in een eenvoudige, makkelijk te volgen structuur.

Een uitgaande webhook integreren met Zapier

1. Maak een Zap:

• Log in op Zapier, maak een nieuwe Zap en selecteer Webhooks by Zapier als de app.



• Kies Catch Hook als triggergebeurtenis en kopieer de webhook-URL die Zapier geeft.

2. Stel de webhook in iubenda in:

• Ga in iubenda naar het onderdeel webhooks in de Consent Database. (Selecteer in het iubenda-dashboard het project en klik op het pictogram Instellingen, open Consent Database-webhooks: Klik in het zijmenu op “Consent Database-webhooks”.



Als je niet weet hoe je bij het webhook-onderdeel moet komen, kijk dan hier ⬇️



• Maak een nieuwe uitgaande webhook, plak de URL van Zapier en selecteer de voorkeur die je wilt synchroniseren (bijv. nieuwsbriefabonnement).



• Sla de webhook op.

3. Test en publiceer:

• Trigger een gebeurtenis in iubenda (bijvoorbeeld een abonnementsupdate).
• Test de webhook in Zapier en verbindt hem met de externe dienst die je wilt synchroniseren (bijv. Mailchimp).



• [Optioneel] Definieer filters of paden:
  • Als je meerdere waarden verstuurt via webhooks (bijvoorbeeld alle nieuwsbriefvoorkeuren), stel dan filters of paden in Zapier in om alleen verder te gaan met specifieke waarden, zoals alleen als de voorkeur is ingesteld op “true”.
  • Voeg de dienst toe die je wilt verbinden (bijv. Mailchimp) en geef de wijzigingen op die je wilt toepassen, zoals het bijwerken van de status van de abonnee op basis van het e-mailveld in de webhook.



• Als alles werkt, publiceer je de Zap.

Een uitgaande webhook integreren met Make

1. Maak een scenario:

• Log in bij Make en maak een nieuw scenario.
• Selecteer Webhooks, kies Custom webhook en kopieer de opgegeven URL.

2. Stel de webhook in iubenda in:

• Ga in iubenda naar het onderdeel webhooks in de Consent Database. (Selecteer in het iubenda-dashboard het project en klik op het pictogram Instellingen, open Consent Database-webhooks: Klik in het zijmenu op “Consent Database-webhooks”.



Als je niet weet hoe je bij het webhook-onderdeel moet komen, kijk dan hier ⬇️



• Maak een nieuwe uitgaande webhook, plak de Make-URL en selecteer de voorkeur die je wilt volgen (bijv. nieuwsbriefupdates).



• Sla de webhook op.

3. Voer uit en automatiseer:

• Klik in Make op Redetermine data structure en trigger een gebeurtenis in iubenda (bijv. een update van een nieuwsbriefabonnement).
• Laat Make de gegevensstructuur detecteren en de webhook verbinden met een tool van derden (bijv. HubSpot).
• Je kunt nu de webhook koppelen aan een dienst zoals Mailchimp of HubSpot en de updates toepassen, zoals het beheren van abonnees op basis van hun e-mail.
• Na bevestiging zal het systeem automatisch starten.
• [Optioneel] Filters toevoegen:
  • Als je meerdere waarden verstuurt, stel dan filters in Make in om alleen te worden getriggerd wanneer specifieke waarden worden verstuurd.

Een uitgaande webhook integreren met N8N

1. Maak een workflow:

• Open N8N en maak een nieuwe workflow.
• Voeg een webhook-knooppunt toe, stel de methode in op POST en kopieer de webhook-URL.

2. Stel de webhook in iubenda in:

• Ga in iubenda naar het onderdeel webhooks in de Consent Database. (Selecteer in het iubenda-dashboard het project en klik op het pictogram Instellingen, open Consent Database-webhooks: Klik in het zijmenu op “Consent Database-webhooks”.



Als je niet weet hoe je bij het webhook-onderdeel moet komen, kijk dan hier ⬇️



• Maak een nieuwe uitgaande webhook, plak de N8N-URL en selecteer de voorkeur die je wilt volgen.



• Sla de webhook op.

3. Test en ga live:

• Check de testgebeurtenis in N8N (bijv. een abonnementsupdate) en laat N8N de gegevensstructuur bevestigen.
• [Optioneel] Filters of paden toevoegen:
  • Als je meerdere waarden verstuurt, kun je filters instellen om alleen bepaalde waarden te verwerken of verschillende paden maken voor verschillende uitkomsten.
  • Verbind nu de webhook met een app zoals Mailchimp en pas eventuele wijzigingen toe, zoals het aanmaken van een nieuw contact.

  

  • Sla je workflow op en activeer hem. Vanaf nu zal elke keer dat een abonnee wordt toegevoegd aan de Consent Database, deze automatisch synchroniseren met Mailchimp.

Geavanceerd: Wat doe je als een webhook mislukt

Soms kan een webhook mislukken door problemen met de bestemmingsserver. Wanneer dit gebeurt, probeert iubenda het verzoek automatisch tot 10 keer opnieuw volgens dit schema:

1. 2 minuten na de eerste storing.
2. Toenemende intervallen (5 minuten, 10 minuten, tot 3 uur).
3. Na 10 mislukte pogingen wordt de webhook gemarkeerd als mislukt en uitgeschakeld.

Hier is het schema voor opnieuw proberen:

• Eerste poging: Na 2 minuten
• Tweede poging: Na nog eens 5 minuten
• Derde poging: Na nog eens 10 minuten
• Vierde poging: Na nog eens 20 minuten
• Vijfde poging: Na nog eens 45 minuten
• Zesde poging: Na 1 uur
• Zevende poging: Na 1,5 uur
• Achtste poging: Na 2 uur
• Negende poging: Na 2,5 uur
• Tiende poging: Na 3 uur

• Na 10 mislukte pogingen wordt de webhook gemarkeerd als mislukt en worden geen nieuwe pogingen ondernomen.

Onderbreker:

Als een webhook 10 keer achter elkaar mislukt, wordt hij automatisch uitgeschakeld. Je ontvangt een e-mail en de webhook wordt gemarkeerd als uitgeschakeld in je webhook instellingen.

Voorbeeld van een webhook-payload

Hier is een voorbeeld van de gegevens die iubenda verstuurt in een webhook:

{
"subject": {
"id": "9b05c70c5c78a31aeaf13f8f27c1f890",
"email": "subject@email.com"
},
"consent_preferences": {
"newsletter": "false"
},
"changes": {
"newsletter": "false"
}
}

• subject: De ID en het e-mailadres van de gebruiker.
• consent_preferences: De bijgewerkte toestemmingsvoorkeuren, zoals het aan- of afmelden voor een nieuwsbrief.
• changes: Eventuele wijzigingen ten opzichte van de vorige toestemming.