Iubenda logo
Générer dès maintenant

Documentation

Sommaire

Intégration des Webhooks avec des services tiers

Gérer le consentement parmi plusieurs outils peut être un défi, mais cela ne doit pas l’être. Avec 2-Way Sync de iubenda, qui fait partie de la Consent Database, la synchronisation de vos consentements marketing sur les plateformes est fluide, en temps réel et entièrement conforme.

Ce guide vous accompagne dans l’intégration de la Consent Database d’iubenda avec des plateformes tierces en utilisant des webhooks sortants, y compris des outils comme Zapier, Make et N8N. Nous aborderons également des sujets avancés, tels que la gestion des tentatives échouées, les nouvelles tentatives et la compréhension de la structure de la charge utile du webhook.

Comment intégrer un webhook sortant avec Zapier

1. Créer un Zap :

  1. Connectez-vous à Zapier, créez un nouveau Zap et choisissez Webhooks by Zapier.
  2. webhooks zapier
  3. Sélectionnez Catch Hook comme événement déclencheur et copiez l’URL du webhook fournie par Zapier.
webhooks zapier 2

2. Configurer le Webhook dans iubenda:

  • Dans iubenda, allez à la section Webhooks sortant. (Depuis le tableau de bord iubenda, sélectionnez le projet et cliquez sur l’icône des paramètres, Ouvrir la Consent Database Webhooks: Dans le menu latéral, cliquez sur « Webhooks de la Consent Database ».

    webhooks zapier 2
  • Créez un nouveau webhook sortant, collez l’URL Zapier et sélectionnez la préférence que vous souhaitez mettre à jour (par exemple, abonnement à la newsletter).
  • webhooks zapier 2
  • Enregistrez le webhook.

3. Tester et Publier

  • Déclencher un événement (par exemple, une mise à jour d’abonnement) et tester le déclencheur dans Zapier.
  • webhooks zapier 2
  • [Optionnel] Définir des filtres ou des chemins:
    • Si vous envoyez plusieurs valeurs via des webhooks (par exemple, toutes les préférences de newsletter), configurez des filtres ou des chemins dans Zapier pour ne procéder qu’avec des valeurs spécifiques, comme uniquement lorsque la préférence est définie sur “true”.
    • Ajoutez le service que vous souhaitez connecter (par exemple, Mailchimp) et spécifiez les modifications que vous souhaitez appliquer, telles que la mise à jour du statut de l’abonné en fonction du champ email dans le webhook.
  • webhooks zapier 2
  • Une fois que tout fonctionne, publiez le Zap.
webhooks zapier 2

💡 Astuce: Utilisez Zap history pour vous assurer que tout fonctionne correctement.

webhooks zapier 2

Comment intégrer un webhook sortant avec Make

1. Créer un scénario :

  • Connectez-vous à Make et créez un nouveau scénario avec Webhooks. Choisissez Webhook personnalisé et copiez l’URL.
webhooks zapier 2

2. Configurer le Webhook dans iubenda:

  • Dans iubenda, allez à la section Webhooks sortant. (Depuis le tableau de bord iubenda, sélectionnez le projet et cliquez sur l’icône des paramètres, Ouvrir la Consent Database Webhooks: Dans le menu latéral, cliquez sur « Webhooks de la Consent Database ».

    webhooks zapier 2
  • Créez un nouveau webhook sortant, collez l’URL Make et sélectionnez la préférence que vous souhaitez suivre (par exemple, les mises à jour de la newsletter).
  • webhooks zapier 2
  • Enregistrez le webhook.

3. Exécuter et automatiser

  • Dans Make, cliquez Redéterminer la structure des données et déclenchez un événement dans iubenda (par exemple, une mise à jour d’abonnement à la newsletter) et laissez Make le détecter.
  • Vous pouvez maintenant lier le webhook à un service comme Mailchimp et appliquer les mises à jour, telles que la gestion des abonnés en fonction de leur e-mail.
  • Une fois confirmé, le système fonctionnera automatiquement.
  • [Optionnel] Ajouter des filtres
    • Si vous envoyez plusieurs valeurs, définissez des filtres dans Make pour déclencher uniquement lorsque des valeurs spécifiques sont envoyées.
webhooks zapier 2

💡 Astuce: Vérifiez le Faire tableau de bord pour surveiller l’intégration.

webhooks zapier 2

Comment intégrer un webhook sortant avec N8N

1. Créer un flux de travail

  • Dans N8N, créez un nouveau flux de travail et ajoutez un Webhook nœud. Définissez la méthode sur POST et copiez l’URL du webhook.
webhooks zapier 2

2. Configurer le Webhook dans iubenda:

  • Dans iubenda, allez à la section Webhooks sortant. (Depuis le tableau de bord iubenda, sélectionnez le projet et cliquez sur l’icône des paramètres, Ouvrir la Consent Database Webhooks: Dans le menu latéral, cliquez sur « Webhooks de la Consent Database ».

    webhooks zapier 2
  • Créez un nouveau webhook sortant, collez l’URL N8N et sélectionnez la préférence que vous souhaitez suivre.
  • webhooks zapier 2
  • Enregistrez le webhook.

3. Tester et mettre en ligne

  • Dans N8N, écoutez l’événement de test (par exemple, une mise à jour d’abonnement), et laissez N8N confirmer la structure des données.
  • [Optionnel] Ajouter des filtres ou des chemins:
    • Si vous envoyez plusieurs valeurs, vous pouvez configurer des filtres pour ne traiter que certaines valeurs ou créer différents chemins pour divers résultats.
    • Maintenant, connectez le webhook à une application comme Mailchimp et appliquez les modifications, telles que la création d’un nouveau contact.
    • webhooks zapier 2
    • Enregistrez votre flux de travail et activez-le. Désormais, chaque fois qu’un abonné est ajouté à la Consent Database, il se synchronisera automatiquement avec Mailchimp.

💡 Astuce: Utilisez l’onglet d’exécution dans N8N pour vous assurer que tout fonctionne correctement.

webhooks zapier 2

Advanced : Que faire si un webhook échoue

Si un webhook échoue parce que le serveur de destination ne répond pas, iubenda réessaie la demande plusieurs fois :

  • Il réessaie 10 fois, en commençant 2 minutes après le premier échec et en augmentant le temps d’attente après chaque tentative. Voici le calendrier de réessai :
    • Première tentative Après 2 minutes
    • Deuxième essai Après 5 minutes de plus
    • Troisième tentative Après 10 minutes de plus
    • Quatrième tentative Après 20 minutes de plus
    • Cinquième tentative Après 45 minutes de plus
    • Sixième essai Après 1 heure
    • Septième essai Après 1,5 heures
    • Huitième essai Après 2 heures
    • Neuvième essai Après 2,5 heures
    • Dixième essai Après 3 heures
  • Après 10 tentatives échouées, le webhook est marqué comme échec et ne sera plus réessayé.

Disjoncteur

Si un webhook échoue 10 fois de suite, il sera automatiquement désactivé. Vous recevrez un e-mail, et il sera marqué comme désactivé dans vos paramètres de webhook.

Exemple de charge utile de Webhook

Voici un exemple des données que iubenda envoie dans un webhook :

{
"subject": {
"id": "9b05c70c5c78a31aeaf13f8f27c1f890",
"email": "subject@email.com"

"consent_preferences": {
"newsletter": "false"

"changes": {
"newsletter": "false"
}
}
  • subject: L’identifiant et l’email de l’utilisateur.
  • consent_preferences: Les préférences de consentement mises à jour, comme s’abonner ou se désabonner d’une newsletter.
  • changes: Toute modification de l’enregistrement de consentement précédent.