Informazioni sui webhook

Nel marketing, ti aiuta a coordinare le tue campagne di marketing con altre azioni sul tuo sito web e su altri canali come messaggi di testo e direct mail. I webhook sono un modo per sincronizzare l’attività di Mailchimp con app di terze parti.

In questo articolo vedremo come creare un webhook nell’app Mailchimp.

Prima di iniziare

• Per utilizzare i webhook, devi avere un piano Standard o Premium. Se utilizzano il piano Essentials o Free, gli utenti possono impostare il webhook e visualizzare la funzionalità, ma verrà chiesto loro di eseguire l’upgrade prima che il punto del percorso venga abilitato. Per modificare il tipo di piano, visita la pagina dei piani nel tuo account.
• Consigliamo i webhook agli utenti che hanno familiarità con la codifica personalizzata. Se hai bisogno di assistenza, contatta il tuo sviluppatore o un esperto Mailchimp.
• Questo articolo spiega come aggiungere webhook a Mailchimp. Per maggiori informazioni su come usare i webhook, consulta la nostra Guida rapida ai webhook.

Come funziona

Quando un contatto esegue un’azione specifica in Mailchimp, ad esempio raggiunge un determinato punto in un Customer Journey o aggiorna il profilo, un webhook attiva un evento in un’app di terze parti. Il webhook invia una richiesta HTTP a un URL con istruzioni e dettagli sull’evento. L’app o l’integrazione che monitora quell’URL invia quindi un messaggio di testo al contatto o esegue altre azioni in un’app di terze parti.

Definizioni

Ecco alcuni termini che incontrerai quando usi i webhook su Mailchimp.

• Webhook
  Un webhook è una richiesta HTTP che consente a un’app di inviare informazioni a un’altra.

• Intestazioni
  Le intestazioni descrivono un aspetto della richiesta. Le intestazioni possono includere qualsiasi informazione che l’app ricevente deve avere per elaborare la richiesta. Molte app chiedono che le intestazioni contengano un tipo di chiave (“Chiave”) e un valore della chiave (“Valore”).

• Tipo di contenuto
  L’opzione relativa al tipo di contenuto ti consente di scegliere il linguaggio di programmazione per il corpo della richiesta. Attualmente, l’editor accetta solo JSON e FormData.

• Payload
  Il payload è il corpo della richiesta. Il formato corretto del corpo è determinato dall’app connessa al webhook.

Webhook come punto del Percorso di acquisto

Un percorso di acquisto è composto da punti di partenza, azioni e regole particolari che imposti sulla base dei tuoi obiettivi di marketing. Per creare un percorso, devi scegliere e organizzare questi elementi in una mappa del percorso.

Ecco come aggiungere un webhook come punto del Percorso di acquisto.

1. Fai clic su “Automations” (Automazioni), quindi su “All journeys” (Tutti i percorsi).
   
2. Fai clic sul pulsante “Create Journey” (Crea il percorso) o su “Finish Setup” (Termina la configurazione) accanto a un percorso esistente.
3. Per aggiungere un punto del percorso, passa il cursore sopra l’ icona più (+) nella fase in cui vuoi inserire il webhook.
4. Fai clic su “Add a Journey Point” (Aggiungi un punto del percorso).
   

5. Fai clic su “Webhook”.
   

6. Nel modulo del builder per i webhook, compila i campi per configurare il tuo webhook. I campi “Webhook Name” (Nome del webhook), “URL Destination” (Destinazione URL), “Username” (Nome utente) e “Password” sono obbligatori.

7. Una volta configurato il webhook, fai clic su “Save” (Salva) per aggiungerlo come punto del percorso.

Ottimo lavoro! Quando inizi o riprendi il tuo percorso, il webhook si attiva non appena l’utente raggiunge il punto del percorso specifico. Il numero di richieste inviate viene visualizzato sul punto del percorso stesso.

Webhooks come punto di contatto di Gestione della campagna

Campaign Manager (Gestione della campagna) di Mailchimp è un’utilità di pianificazione delle campagne end-to-end. Imposta un obiettivo e organizza le attività, gli eventi, le email e i webhook a partire da un pianificatore centralizzato.

Per aggiungere un webhook come punto di contatto di Gestione della campagna, segui questi passaggi.

1. Fai clic su “Campaigns” (Campagne), quindi su “Campaign Manager” (Gestione della campagna).
   

2. Fai clic sul pulsante “Create Campaign” (Crea la campagna) oppure sulla campagna attiva a cui vuoi aggiungere un punto di contatto webhook.

3. Fai clic sul menu a tendina “Add touchpoint” (Aggiungi un punto di contatto) e poi su “Webhook”.

4. Nel modulo del Builder per i webhook, compila i campi per configurare e pianificare il webhook.

   Il pubblico selezionato durante la configurazione della campagna viene utilizzato per impostazione predefinita. Se non vuoi attivare un’azione webhook per tutto il tuo pubblico, seleziona un segmento o un tag esistente del tuo pubblico nella sezione “Segment or Tag” (Segmento o tag) del modulo.

5. Dopo aver configurato il tuo webhook e aver impostato data e ora, fai clic su “Schedule webhook” (Pianifica il webhook) per aggiungerlo come punto di contatto della campagna.

Eccellente! Puoi visualizzare il punto di contatto webhook sul calendario. Dopo la data e l’ora programmate, questo viene visualizzato come completato.

Configurazione del webhook del pubblico

Per inviare aggiornamenti sul tuo pubblico a un’altra app, puoi configurare un webhook del pubblico. I webhook possono inviare una richiesta all’URL di tua scelta quando si verificano aggiornamenti specifici nel pubblico, ad esempio se un utente si iscrive o quando viene aggiornato un profilo.

Ecco come aggiungere un webhook al tuo pubblico.

1. Fai clic su Pubblico, quindi fai clic su Dashboard Pubblico.
   
2. Se hai più di un pubblico, fai clic sul menu a tendina “Current audience” (Pubblico attuale) e seleziona quello desiderato.
3. Fai clic sul menu a tendina Gestisci pubblico e seleziona Impostazioni.

4. Fai clic su “Webhooks” (Webhook).
   

5. Fai clic su “Create New Webhook” (Crea un nuovo webhook).

6. Inserisci un “Callback URL” (URL di richiamata). Questo è l’URL a cui il webhook invia le richieste.

7. Seleziona tutte le azioni che desideri attivare per un webhook. Ecco le opzioni disponibili:

   • Iscritti
   • Disiscrizione
   • Aggiornamenti del profilo
   • Indirizzo rimosso
   • Email modificata
   • Invio della campagna in corso

8. Puoi anche scegliere di inviare aggiornamenti solo quando viene effettuata una modifica da parte di un iscritto, di un amministratore dell’account o tramite l’API.

9. Fai clic su “Save” (Salva).

Ecco fatto! Quando si verifica una delle azioni selezionate, il webhook invia una richiesta all’URL inserito.