Integrazione Webhook con servizi di terze parti

Gestire il consenso attraverso più strumenti può essere impegnativo—ma non deve per forza esserlo. Con 2-Way Sync di iubenda, parte del Consent Database, la sincronizzazione dei consensi di marketing avviene in modo semplice, immediato e conforme.

Questa guida ti spiega su come integrare il Consent Database di iubenda con piattaforme di terze parti utilizzando webhook in uscita, inclusi strumenti come Zapier, Make e N8N. Tratteremo anche argomenti avanzati, come la gestione dei tentativi falliti, i nuovi tentativi e la comprensione della struttura del payload del webhook.

Come integrare un webhook in uscita con Zapier

1. Crea un Zap:

1. Accedi a Zapier, crea un nuovo Zap e scegli Webhooks by Zapier.



2. Seleziona Catch Hook come evento di attivazione e copia l’URL del webhook fornito da Zapier.

2. Imposta il Webhook in iubenda:

• In iubenda, vai alla sezione Webhook in uscita. (Dalla dashboard di iubenda, seleziona il progetto e fai clic sull’icona delle impostazioni, apri i webhook del Consent Database: Nel menu laterale, clicca su “Webhook del Consent Database”)
  
  

  Se non sai come accedere alla sezione dei webhook, controlla qui

  

• Crea un nuovo webhook in uscita, incolla l’URL di Zapier e seleziona la preferenza che desideri aggiornare (ad esempio, iscrizione alla newsletter).



• Salva il webhook.

3. Testa e Pubblica:

• Attiva un evento (ad esempio, un aggiornamento dell’abbonamento) e testa il trigger in Zapier.



• [Opzionale] Definisci filtri o percorsi:
  • Se invii più valori tramite webhook (ad esempio, tutte le preferenze per la newsletter), configura filtri o percorsi in Zapier per procedere solo con valori specifici, come quando la preferenza è impostata su “true”.
  • Aggiungi il servizio che desideri connettere (ad esempio, Mailchimp) e specifica le modifiche che desideri applicare, come l’aggiornamento dello stato dell’iscritto in base al campo email nel webhook.



• Una volta che tutto funziona, pubblica lo Zap.

Come integrare un webhook in uscita con Make

1. Crea uno Scenario:

• Accedi a Make e crea un nuovo scenario con Webhooks. Scegli Webhook personalizzato e copia l’URL.

2. Imposta il Webhook in iubenda:

• In iubenda, vai alla sezione Webhook in uscita. (Dalla dashboard di iubenda, seleziona il progetto e fai clic sull’icona delle impostazioni, apri i webhook del Consent Database: Nel menu laterale, clicca su “Webhook del Consent Database”)
  
  

  Se non sai come accedere alla sezione dei webhook, controlla qui

  

• Crea un nuovo webhook in uscita, incolla l’URL di Make e seleziona la preferenza che desideri monitorare (ad esempio, aggiornamenti della newsletter).



• Salva il webhook.

3. Esegui e Automatizza

• In Make, clicca Ridefinisci la struttura dei dati e attiva un evento in iubenda (ad esempio, un aggiornamento dell’iscrizione alla newsletter) e lascia che Make lo rilevi.
• Puoi ora collegare il webhook a un servizio come Mailchimp e applicare gli aggiornamenti, come gestire gli iscritti in base alla loro email.
• Una volta confermato, il sistema verrà eseguito automaticamente.
• [Opzionale] Aggiungi Filtri:
  • Se invii più valori, imposta i filtri in Make per attivarsi solo quando vengono inviati valori specifici.

Come integrare un webhook in uscita con N8N

1. Crea un flusso di lavoro:

• In N8N, crea un nuovo workflow e aggiungi un nodoWebhook. Imposta il metodo su POST e copia l’URL del webhook.

2. Imposta il Webhook in iubenda:

• In iubenda, vai alla sezione Webhook in uscita. (Dalla dashboard di iubenda, seleziona il progetto e fai clic sull’icona delle impostazioni, apri i webhook del Consent Database: Nel menu laterale, clicca su “Webhook del Consent Database”)
  
  

  Se non sai come accedere alla sezione dei webhook, controlla qui

  

• Crea un nuovo webhook in uscita, incolla l’URL di N8N e seleziona la preferenza che desideri monitorare.



• Salva il webhook.

3. Testa e vai online:

• In N8N, ascolta l’evento di test (ad esempio, un aggiornamento dell’abbonamento), e lascia che N8N confermi la struttura dei dati.
• [Opzionale] Aggiungi filtri o percorsi
  • Se invii più valori, puoi impostare filtri per elaborare solo determinati valori o creare percorsi diversi per diversi tipi di risultati.
  • Ora, collega il webhook a un’app come Mailchimp e applica eventuali modifiche, come la creazione di un nuovo contatto.

  

  • Salva il tuo workflow e attivalo. Da questo momento in poi, ogni volta che un isc viene aggiunto al Consent Database, la sincronizzazione con Mailchimp avverrà automaticamente.

Avanzato: Cosa fare se un webhook fallisce

Se un webhook fallisce perché il server di destinazione non risponde, iubenda ripete la richiesta più volte:

• Riprova 10 volte, iniziando 2 minuti dopo il primo fallimento e aumentando il tempo di attesa dopo ogni tentativo. Ecco il programma di ripetizione:
  • Primo tentativo Dopo 2 minuti
  • Secondo tentativo Dopo 5 minuti in più
  • Terzo tentativo Dopo altri 10 minuti
  • Quarto tentativo Dopo altri 20 minuti
  • Quinto tentativo Dopo altri 45 minuti
  • Sesto tentativo: Dopo 1 ora
  • Settimo tentativo Dopo 1,5 ore
  • Ottava prova Dopo 2 ore
  • Nono tentativo Dopo 2,5 ore
  • Decima tentativo Dopo 3 ore
• Dopo 10 tentativi falliti, il webhook è contrassegnato come failed e non verrà riprovato di nuovo.

Interruttore automatico

Se un webhook fallisce 10 volte di seguito, verrà automaticamente disabilitato. Riceverai un’email e sarà contrassegnata come disabilitata nelle impostazioni del tuo webhook.

Esempio di Payload Webhook

Ecco un esempio dei dati che iubenda invia in un webhook:

{
Interessato
ID "9b05c70c5c78a31aeaf13f8f27c1f890",
"email": "subject@email.com"
},
"consent_preferences": {
"newsletter": "falso"
},
"changes": {
"newsletter": "falso"
}
}

• subject: L’utente ID e email.
• consent_preferences: Le preferenze relative al consenso aggiornate, come l’iscrizione o la disiscrizione a una newsletter.
• changes: Qualsiasi modifica rispetto ai dati di consenso precedenti.