I webhook in uscita ti consentono di inviare dati in tempo reale da Brevo a un'app esterna. Quando si verifica un evento specifico in Brevo, la tua app esterna riceve una notifica contenente i dettagli dell'evento.

Puoi creare webhook in uscita per eventi relativi alle seguenti funzionalità di Brevo:

Buono a sapersi

• Tutti i webhook in uscita esistenti creati dalle pagine Contacts (Contatti), Campaigns (Campagne) o Transactional (Transazionale) tramite l'esperienza classica di gestione dei webhook sono stati migrati alla pagina Webhooks (Webhook).
• Puoi creare fino a 40 webhook in uscita nel tuo account Brevo. Se superi questo limite, elimina un webhook esistente per crearne uno nuovo.
• Puoi creare webhook in uscita anche da un'automazione o dall'API.
• Se vuoi creare webhook in entrata per ricevere dati in tempo reale da un'altra app in Brevo, consulta il nostro articolo dedicato Creazione di webhook in entrata per ricevere dati in tempo reale in Brevo.

Prima di iniziare

Assicurati di recuperare dall'app esterna:

• L'URL del server o dell'endpoint a cui vuoi inviare il webhook in uscita
• (Opzionale) Il metodo di autenticazione e le credenziali richieste
• Qualsiasi nome e valore di intestazione obbligatorio

Se non sai dove recuperare queste informazioni, consulta il centro assistenza della tua app esterna o contatta il relativo team di assistenza.

Fase 1: creazione di un webhook in uscita in Brevo

Per iniziare, devi creare un webhook in uscita in Brevo.

1. In Brevo, clicca sul tuo nome account e seleziona Integrations (Integrazioni).
2. Vai alla scheda Webhooks (Webhook).
3. Clicca su Add webhook (Aggiungi webhook).
4. Seleziona Outbound webhook (Webhook in uscita).
5. Clicca su Add webhook (Aggiungi webhook).
   

Fase 2: configurazione del webhook in uscita

Quindi, configura il nome, l'URL e il metodo di autenticazione del webhook in uscita.

1. Dai un nome al webhook.
2. Clicca su Continue (Continua).
3. 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.
   

4. (Opzionale) Per impostazione predefinita, come metodo di autenticazione è selezionata l'opzione No authentication (Nessuna autenticazione). Per aggiungere un ulteriore livello di sicurezza o se l'app esterna a cui stai inviando il webhook lo richiede, puoi scegliere tra:

   • Autenticazione Basic (Base) (nome utente e password), oppure

   • Autenticazione Token
     

5. (Opzionale) Per aggiungere un'intestazione al webhook in uscita:
   1. Clicca su + Add an object (+ Aggiungi un oggetto).
   2. Immetti il nome e il valore dell'intestazione.
      
6. Clicca su Continue (Continua).

Fase 3: scelta degli eventi e invio delle richieste di test

Infine, scegli gli eventi per cui vuoi ricevere il webhook in uscita e invia le richieste di test all'app esterna.

1. Seleziona la categoria dell'evento per cui vuoi creare un webhook in uscita (ad es. Transactional email (Email transazionale), Deals (Trattative), Forms (Moduli), ecc.)).
   
   💡 Buono a sapersi

   Gli eventi di Contacts (Contatti) si trovano nella categoria dell'evento Marketing emails (Email di marketing).
2. Per impostazione predefinita, vengono attivati tutti gli eventi nella categoria selezionata. Se necessario, puoi disattivare eventi specifici deselezionandoli.
   
3. (Opzionale) Per inviare richieste di test per gli eventi:
   1. Clicca sull'icona con i tre puntini accanto a un evento e seleziona Send test request (Invia richiesta di test).
      
   2. Controlla l'app esterna per verificare se hai ricevuto il webhook in uscita.
4. Al termine, clicca su Activate webhook (Attiva webhook).

Protezione dei webhook in uscita

Per proteggere i tuoi webhook in uscita, devi inserire nella whitelist 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.

Eliminazione di un webhook in uscita

Se non hai più bisogno di un webhook in uscita, puoi eliminarlo definitivamente.

1. In Brevo, clicca sul tuo nome account e seleziona Integrations (Integrazioni).
2. Vai alla scheda Webhooks (Webhook).
3. Seleziona l'opzione Outbound webhook (Webhook in uscita).
4. Accanto al webhook in uscita che vuoi eliminare, clicca sull'icona del cestino 🗑️.
   
5. Clicca su Delete webhook (Elimina webhook) per confermare.

Il webhook in uscita è stato eliminato definitivamente.

🤔 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.