Het beheren van toestemming in meerdere tools kan een uitdaging zijn, maar dat hoeft niet. Met iubenda’s 2-Way Sync, onderdeel van de Consent Database, is het synchroniseren van je marketingtoestemmingen tussen platforms naadloos, real-time en volledig compliant.
In deze gids lees je hoe je iubenda’s Consent Database kunt integreren met platforms van derden door middel van uitgaande webhooks, waaronder tools als Zapier, Make en N8N. We behandelen ook geavanceerde onderwerpen, zoals het afhandelen van mislukte pogingen, retries en het begrijpen van de payloadstructuur van webhooks.
Hoe een uitgaande webhook integreren met Zapier
1. Maak een Zap:
Log in op Zapier, maak een nieuwe Zap en kies Webhooks by Zapier.
Selecteer Catch Hook als triggergebeurtenis en kopieer de webhook URL die Zapier geeft.
2. Stel de Webhook in iubenda in:
Ga in iubenda naar de sectie Uitgaande webhook. (Selecteer in het iubenda Dashboard het project en klik op het instellingen icoon, Open Consent Database Webhooks: Klik in het zijmenu op “Consent Database-webhooks”.
Als je niet weet hoe je bij de webhooks sectie moet komen, kijk dan hier
Maak een nieuwe Outbound webhook, plak de URL van Zapier en selecteer de voorkeur die je wilt bijwerken (bijv. nieuwsbriefabonnement).
Sla de webhook op.
3. Test en publiceer:
Trigger een gebeurtenis (bijvoorbeeld een abonnementsupdate) en test de trigger in Zapier.
[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 service 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.
💡 Tip: Gebruik de Zap-geschiedenis om te controleren of alles soepel verloopt.
Een uitgaande webhook integreren met Make
1. Maak een scenario:
Log in bij Make en maak een nieuw scenario met Webhooks. Kies Aangepaste webhook en kopieer de URL.
2. Stel de Webhook in iubenda in:
Ga in iubenda naar de sectie Uitgaande webhook. (Selecteer in het iubenda Dashboard het project en klik op het instellingen icoon, Open Consent Database Webhooks: Klik in het zijmenu op “Consent Database-webhooks”.
Als je niet weet hoe je bij de webhooks sectie moet komen, kijk dan hier
Maak een nieuwe Outbound webhook, plak de URL Maken en selecteer de voorkeur die je wilt volgen (bijv. nieuwsbriefupdates).
Sla de webhook op.
3. Uitvoeren en automatiseren:
Klik in Make op Gegevensstructuur opnieuw bepalen en trigger een gebeurtenis in iubenda (bijvoorbeeld een update van een nieuwsbriefabonnement) en laat Make dit detecteren.
Je kunt nu de webhook koppelen aan een service als Mailchimp 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 triggeren wanneer specifieke waarden worden verstuurd.
💡 Tip: Bekijk het Make dashboard om de integratie te controleren.
Hoe een uitgaande webhook integreren met N8N
1. Maak een workflow:
Maak in N8N een nieuwe workflow en voeg een Webhook knooppunt toe. Stel de methode in op POST en kopieer de URL van de webhook.
2. Stel de Webhook in iubenda in:
Ga in iubenda naar de sectie Uitgaande webhook. (Selecteer in het iubenda Dashboard het project en klik op het instellingen icoon, Open Consent Database Webhooks: Klik in het zijmenu op “Consent Database-webhooks”.
Als je niet weet hoe je bij de webhooks sectie moet komen, kijk dan hier
Maak een nieuwe Outbound webhook, plak de N8N URL en selecteer de voorkeur die je wilt volgen.
Sla de webhook op.
3. Test en ga live:
Luister in N8N naar de testgebeurtenis (bijvoorbeeld 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.
💡 Tip: Gebruik het tabblad Uitvoering in N8N om te controleren of alles goed werkt.
Geavanceerd: Wat te doen als een Webhook mislukt
Als een webhook mislukt omdat de bestemmingsserver niet reageert, probeert iubenda het verzoek meerdere keren opnieuw:
Het probeert het 10 keer opnieuw, beginnend 2 minuten na de eerste mislukking en verlengt de wachttijd na elke poging. 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 wordt hij niet opnieuw geprobeerd.
Stroomonderbreker:
Als een webhook 10 keer achter elkaar mislukt, wordt hij automatisch uitgeschakeld. Je ontvangt een e-mail en het wordt gemarkeerd als uitgeschakeld in je webhook instellingen.
Webhook Payload Voorbeeld
Hier is een voorbeeld van de gegevens die iubenda verstuurt in een webhook:
