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

• Puoi creare fino a 40 webhook in uscita per account Brevo. Se raggiungi questo limite, elimina un webhook esistente prima di crearne uno nuovo.
• Puoi creare webhook in uscita anche da un'automazione o dall'API.
• Per 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 creare un webhook in uscita in Brevo:

1. In Brevo, clicca sul nome account e seleziona Integrations (Integrazioni) > Webhooks (Webhook).
2. Clicca su Add webhook (Aggiungi webhook).
3. Seleziona Outbound webhook (Webhook in uscita).
4. 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. Seleziona la tua strategia di invio dei webhook:
   • Invio singolo
     Invia gli eventi singolarmente in tempo reale.
   • Invio in blocco
     Invia gli eventi in blocchi fino a 500 unità. Questa opzione è consigliata se hai limiti di velocità inferiori, poiché può ridurre il numero di richieste.
7. 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.

Monitoraggio della consegna dei webhook e configurazione degli avvisi

Monitora la consegna dei tuoi eventi webhook in uscita e configura gli avvisi per ricevere notifiche quando si verificano problemi.

Esame delle statistiche dei webhook

La dashboard di monitoraggio ti aiuta a monitorare lo stato di consegna degli eventi webhook in uscita. In questo modo, puoi identificare rapidamente i problemi di consegna.

Per esaminare le statistiche degli eventi webhook in uscita:

1. In Brevo, clicca sul nome account e seleziona Integrations (Integrazioni) > Webhooks (Webhook).
2. Dalla scheda Outbound webhooks (Webhooks in uscita), clicca sul webhook in uscita che vuoi monitorare.

3. In Statistics (Statistiche), esamina lo stato di consegna degli eventi webhook in uscita:

   📨 Stati di consegna📊 Grafico a barre

   

   Visualizza il numero di eventi webhook in uscita delle ultime 24 ore in tre stati di consegna:

   • ❌ Failed (Non riusciti): il numero di eventi webhook in uscita univoci che non è stato possibile consegnare dopo 24 ore di tentativi e che sono stati scartati.
   • ⚠️ Retries (Tentativi): il numero di eventi webhook in uscita univoci attualmente in fase di nuovo tentativo nelle ultime 24 ore. Per ulteriori informazioni sul meccanismo di nuovo tentativo, consulta la nostra documentazione API dedicata.
   • ✅ Delivered (Consegnati): il numero di eventi webhook in uscita univoci consegnati correttamente nelle ultime 24 ore.

   

   Il grafico a barre progressivo su 24 ore mostra il numero di eventi webhook in uscita in ciascuno stato con una suddivisione oraria. Puoi posizionare il puntatore del mouse su una barra per visualizzare il numero esatto di eventi webhook in uscita univoci in fase di nuovo tentativo, consegnati e non andati a buon fine in una determinata ora.

Configurazione degli avvisi webhook

Imposta avvisi email per ricevere una notifica quando i problemi di consegna degli eventi webhook in uscita raggiungono una soglia stabilita. Gli avvisi vengono inviati all'email predefinita del tuo account, con un massimo di una notifica l'ora quando viene raggiunta la soglia.

Per configurare gli avvisi webhook:

1. In Alert configuration (Configurazione avvisi), attiva gli avvisi che desideri ricevere:
   • Retry alert (Avviso di nuovo tentativo)
     Imposta una soglia per ricevere una notifica quando il numero di eventi webhook in uscita in nuovo tentativo raggiunge questo valore. La soglia minima è 50.
   • Fail alert (Avviso di evento non andato a buon fine)
     Imposta una soglia per ricevere una notifica quando il numero di eventi webhook in uscita non riusciti raggiunge questo valore. La soglia minima è 50.
     
2. Clicca su Save (Salva).

Disattivazione di un webhook in uscita

Se devi interrompere temporaneamente l'invio di dati da Brevo alla tua app esterna, puoi disattivare il webhook in uscita.

1. In Brevo, clicca sul menu a discesa dell'account e seleziona Integrations (Integrazioni).
2. Vai alla scheda Webhooks (Webhook).
3. Seleziona l'opzione Outbound webhook (Webhook in uscita).
4. Deseleziona il webhook in uscita che vuoi disattivare.
    

Il webhook in uscita è ora disattivato (interruttore grigio). Puoi riattivarlo in qualsiasi momento selezionandolo di nuovo.

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.