Se hai familiarità con le metriche dettagliate offerte da Brevo per le email, sai bene quanto possa essere frustrante cercare di dare un senso a tutto questo. Trovare le informazioni necessarie tra tutti i dati disponibili è come cercare un ago nel pagliaio, ma i webhook ti consentono di ricevere direttamente i dati giusti per accedere senza problemi alle informazioni importanti di cui hai bisogno.
Che cos'è un webhook?
I webhook possono essere definiti come notifiche che vengono attivate da eventi specifici. In genere, vengono utilizzati per facilitare la comunicazione tra più sistemi. In sostanza, i webhook forniscono un mezzo semplice e diretto per ricevere avvisi ogni volta che si verifica un evento in un altro sistema.
In termini più tecnici, un webhook è un callback HTTP che consente a più sistemi di interconnettersi e di mantenere le azioni coerenti tra loro. Quando si verifica un evento in un sistema, viene inviata una richiesta POST in tempo reale all'URL indicato. Questa richiesta HTTP POST contiene informazioni relative a quell'evento specifico, ad esempio l'ora in cui si è verificato, il nome dell'evento e gli identificatori chiave.
Come funzionano i webhook in Brevo?
In Brevo, un webhook è un URL che puoi integrare nel nostro sistema per ricevere aggiornamenti in tempo reale sugli eventi relativi all'invio delle tue email di marketing e transazionali e alla gestione dei tuoi contatti. Con i webhook, hai la possibilità di monitorare gli eventi specifici che ti interessano, ad es. l'apertura di un'email o l'eliminazione di un contatto.
Puoi monitorare diversi tipi di eventi. Ad esempio, puoi ricevere notifiche sullo stato della tua campagna di marketing in corso e sapere in tempo reale come sta andando. Puoi anche monitorare il momento in cui i tuoi messaggi transazionali vengono inviati, consegnati o aperti dai destinatari. Oppure puoi anche ricevere una notifica per le modifiche apportate ai tuoi contatti.
Quali eventi sono disponibili in Brevo?
Tutti gli eventi disponibili che puoi monitorare in Brevo sono raggruppati in due categorie:
| Quando un'email è: | Quando un contatto è: |
|
|
Per ulteriori informazioni sugli eventi di marketing e sui dati a essi associati, consulta la nostra documentazione API.
| Quando un'email è: | |
|
|
Per ulteriori informazioni sugli eventi transazionali e sui dati a essi associati, consulta la nostra documentazione API.
Creazione del webhook
Per i nostri esempi, ci concentreremo sull'evento "Opened" (Aperto) della piattaforma transazionale. In pratica, ogni volta che inviamo una nuova email transazionale, riceveremo una notifica tramite il nostro webhook che indica che l'email è stata recapitata correttamente nella casella di posta in arrivo del destinatario.
-
Accedi alla pagina Webhooks (Webhook):
- Per gli eventi di marketing, vai su Contacts (Contatti) > Settings (Impostazioni) > Webhooks (Webhook) o su Campaigns (Campagne) > Settings (Impostazioni) > Webhooks (Webhook).
- Per gli eventi transazionali, vai su Transactional (Transazionale) > Settings (Impostazioni) > Webhooks (Webhook).
- Clicca su Add a new webhook (Aggiungi un nuovo webhook).
- Nel campo URL, inserisci l'URL di notifica dove verranno inviati i dati dell'evento ogni volta che viene attivato.
- Nei campi When the message is (Quando il messaggio è) o When the contact is (Quando il contatto è), seleziona gli eventi per i quali desideri ricevere le notifiche.
- Nel campo Description (Descrizione), inserisci una descrizione per il webhook.
- Al termine, clicca su Save (Salva).
- Dopo aver creato il tuo webhook, ti consigliamo di testarlo. Accanto al webhook che hai creato, clicca su Actions (Azioni) > Send a test (Invia un test) o Test. Quando l'evento è stato attivato, riceverai una notifica sull'URL che hai specificato per il webhook.
Quando crei un webhook da un'automazione, ricevi una notifica ogni volta che un contatto raggiunge la fase Call a webhook (Chiama un webhook) nella tua automazione.
- Vai su Automations (Automazioni).
- Clicca su Create an automation (Crea un'automazione).
- Utilizza un'automazione predefinita o creane una personalizzata.
- Aggiungi un punto di ingresso alla tua automazione.
- (Opzionale) Aggiungi le fasi che i tuoi contatti devono eseguire prima di attivare il tuo webhook.
- Aggiungi la fase Call a webhook (Chiama un webhook) alla tua automazione:
- Sotto l'ultima fase della tua automazione, clicca su +.
- Seleziona la fase Call a webhook (Chiama un webhook).
- Nel campo Enter the URL (Inserisci l'URL), inserisci l'URL di notifica dove verranno inviati i dati dell'evento ogni volta che viene attivato.
- (Opzionale) Per ricevere informazioni sul contatto che ha attivato l'evento, abilita l'opzione I want to send contact properties to the webhook (Voglio inviare le proprietà del contatto al webhook).
- Clicca su OK.
- (Opzionale) Aggiungi altre fasi alla tua automazione.
- Prova la tua automazione per assicurarti di ricevere le informazioni.
- Clicca su Activate the automation (Attiva l'automazione) per consentire ai tuoi contatti di accedere all'automazione.
Per creare un webhook dall'API, devi solo effettuare una semplice chiamata per configurare l'URL del webhook che desideri utilizzare. Ecco un esempio di chiamata:
| curl --request POST \ --url https://api.brevo.com/v3/webhooks \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "url": "http://requestb.in/173lyyx1", "description": "Webhook triggered on opened emails", "events": [ "opened" ], "type": "transactional", "domain": "example.com" } ' |
Per ulteriori informazioni sulla creazione di webhook dall'API, consulta la nostra documentazione API.
Protezione del webhook
Dopo aver creato e testato il tuo webhook, ti consigliamo di proteggerlo per garantire che non sia accessibile ad altre parti sul web. Per proteggere i tuoi webhook, devi inserire nella whitelist i seguenti intervalli IP di Brevo:
-
1.179.112.0/20-
Primo indirizzo IP:
1.179.112.1 -
Ultimo indirizzo IP:
1.179.127.254
-
Primo indirizzo IP:
🤔 Domande?
In caso di domande, non esitare a contattare il team dell’assistenza creando un ticket dal tuo account. Se ancora non hai un account, puoi contattarci qui.
Se stai cercando aiuto per un progetto che prevede l'utilizzo di Brevo, possiamo metterti in contatto con il giusto partner esperto certificato Brevo.