Integrazione Webhook con servizi di terze parti

Gestire il consenso su più piattaforme è una sfida per molte aziende, ma non deve esserlo per forza. Con 2-Way Sync di iubenda, che fa parte del Consent Database, puoi tenere aggiornati gli stati del consenso in tempo reale su tutti i tuoi strumenti di terze parti. È una funzione che ti aiuta a mantenere la conformità, a migliorare l’accuratezza e a semplificare il processo di gestione delle preferenze degli utenti.

Questa guida ti mostrerà come configurare la 2-Way Sync utilizzando il Consent Database di iubenda con piattaforme come Zapier, Make e N8N. Imparerai anche come gestire problemi comuni come i tentativi di ripetizione e gli errori, il tutto in una struttura semplice e facile da seguire.

Come integrare un webhook in uscita con Zapier

1. Crea un Zap:

• Accedi a Zapier, crea un nuovo Zap e seleziona Webhooks by Zapier come applicazione.



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

2. Imposta il Webhook in iubenda:

• Su iubenda, vai alla sezione Webhooks del Consent Database. (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 webhooks, guarda qui ⬇️



• Crea un nuovo webhook in uscita, incolla l’URL fornito da Zapier e seleziona la preferenza che vuoi sincronizzare (ad esempio, l’iscrizione alla newsletter).



• Salva il webhook.

3. Testa e Pubblica:

• Attiva un evento in iubenda (ad esempio, l’aggiornamento di un abbonamento).
• Prova il webhook in Zapier e collegalo al servizio di terze parti che vuoi sincronizzare (ad esempio, Mailchimp).



• [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.
• Seleziona Webhooks, scegli Webhook personalizzato e copia l’URL fornito.

2. Imposta il Webhook in iubenda:

• Su iubenda, vai alla sezione Webhooks del Consent Database. (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 webhooks, guarda qui ⬇️



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



• Salva il webhook.

3. Esegui e Automatizza

• Su Make, clicca su Ridetermina la struttura dei dati e attiva un evento in iubenda (ad esempio, l’aggiornamento di un abbonamento alla newsletter).
• Lascia che Make rilevi la struttura dei dati e colleghi il webhook a uno strumento di terze parti (ad esempio, HubSpot).
• Ora puoi collegare il webhook a un servizio come Mailchimp o HubSpot e applicare gli aggiornamenti, come la gestione degli 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:

• Apri N8N e crea un nuovo workflow.
• Aggiungi un nodo Webhook, imposta il metodo su POST e copia l’URL del webhook.

2. Imposta il Webhook in iubenda:

• Su iubenda, vai alla sezione Webhooks del Consent Database. (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 webhooks, guarda qui ⬇️



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



• 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

A volte un webhook può fallire a causa di problemi con il server di destinazione. Quando succede, iubenda riprova automaticamente la richiesta fino a 10 volte, seguendo questo schema:

1. 2 minuti dopo il primo fallimento.
2. Intervalli crescenti (5 minuti, 10 minuti, fino a 3 ore).
3. Dopo 10 tentativi falliti, il webhook viene contrassegnato come fallito e viene disattivato.

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.