L'invio di webhook in uscita da un'automazione ti consente di inviare una notifica in tempo reale con i dati dell'evento da Brevo a un'app esterna quando un contatto raggiunge la fase Call a webhook (Chiama un webhook).
Questo articolo spiega come inviare webhook in uscita da un'automazione. Puoi creare webhook in uscita anche configurandoli direttamente nel tuo account Brevo o dall'API.
Prima di iniziare
Dall'app esterna, assicurati di recuperare l'URL del server o dell'endpoint a cui vuoi inviare il webhook in uscita. Se non sai dove recuperarlo, consulta il centro assistenza della tua app esterna o contatta il relativo team di assistenza.
Invio di webhook in uscita da un'automazione
Per inviare webhook in uscita da un'automazione, devi aggiungere la fase Call a webhook (Chiama un webhook) e configurarla con l'URL del webhook e i dettagli di autenticazione.
Utilizza le schede seguenti per visualizzare le istruzioni per il nuovo editor di automazione o per quello classico:
- In un'automazione creata utilizzando il nuovo editor, aggiungi la fase Call a webhook.
- Inserisci l'URL del server o dell'endpoint a cui vuoi inviare i tuoi eventi. Questo indica a Brevo dove inviare il webhook in uscita quando si verifica un evento.
- Seleziona un Metodo di autenticazione dal menu a discesa:
- Nessuna autenticazione: Il webhook verrà inviato senza credenziali di autenticazione.
- Base: Inserisci nome utente e password. Brevo codifica queste credenziali e le invia con ogni richiesta webhook.
- Token: inserisci il tuo token di autenticazione. Brevo invierà questo token con ogni richiesta webhook.
-
(Facoltativo) Fai clic su Add object (Aggiungi oggetto) per aggiungere intestazioni personalizzate alla tua richiesta webhook. Immetti il nome e il valore dell'intestazione. Puoi aggiungere più intestazioni, se necessario.
💡 Buono a sapersiLe intestazioni personalizzate sono utili per l'autenticazione o per passare metadati aggiuntivi alla tua app esterna. - (Facoltativo) Nella sezione Impostazioni aggiuntive, configura quali dati includere nel webhook:
- Includi i dettagli del contatto che ha attivato l’evento: quando attivata, Brevo include nel webhook tutti gli attributi del contatto. Per impostazione predefinita, sono inclusi solo l'ID contatto, l'email, l'ID step e l'ID scenario.
- Includi i dettagli dell'evento scatenante: quando viene attivato, Brevo include i dati dell'evento dal payload nel webhook.
- Clicca su Save (Salva) per salvare la fase.
- Finisci di configurare la tua automazione e attivala.
- Da un'automazione creata utilizzando l'editor classico, aggiungi un punto di ingresso.
- (Opzionale) Aggiungi le fasi che desideri vengano eseguite dai tuoi contatti prima di attivare il webhook.
- Aggiungi la fase Call a webhook (Chiama un webhook) alla tua automazione:
- Nell'area di lavoro, clicca sul segno più + dove vuoi aggiungere la fase Call a webhook (Chiama un webhook).
- Seleziona la fase Call a webhook (Chiama un webhook).
-
Incolla l'URL del webhook fornito dalla tua app esterna. Questo URL di callback indica a Brevo dove inviare i dati quando si verifica un evento.
💡 Buono a sapersiL'URL del webhook deve essere generato e recuperato dalla tua app esterna. Se non sai dove recuperarlo, consulta il centro assistenza della tua app esterna o contatta il relativo team di assistenza. - (Opzionale) Attiva l'opzione I want to send contact properties to the webhook (Voglio inviare le proprietà del contatto al webhook) per includere le proprietà del contatto nel webhook.
- Clicca su OK.
- Finisci di configurare la tua automazione e attivala.
Protezione dei webhook in uscita
Per proteggere i tuoi webhook in uscita, inserisci nella lista di autorizzazione alcuni intervalli IP di Brevo. Ciò garantisce che solo le richieste autorizzate possano attivare i webhook.
➡️ Per ulteriori informazioni, consulta il nostro articolo dedicato Intervalli IP di Brevo: lista dei servizi esposti pubblicamente.
⏭️ E adesso?
- Creazione di webhook in uscita per inviare dati in tempo reale da Brevo a un'app esterna
- Creazione di webhook in entrata per ricevere dati in tempo reale da un'altra app in Brevo
🤔 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 l'agenzia partner di Brevo giusta per te.