I webhook in entrata ti consentono di ricevere dati in tempo reale in Brevo da un'app esterna. Ogni volta che si verifica un evento nella tua app esterna, Brevo riceve un webhook contenente i dettagli dell'evento. Ora, puoi eseguire queste operazioni:

• Attivazione di un evento personalizzato in Brevo e/o
• Creazione o aggiornamento automatico di un contatto in base ai dati ricevuti.

Buono a sapersi

• Le webhook in entrata sono attualmente in fase di implementazione graduale e potrebbero non essere ancora disponibili per tutti gli account.
• Puoi creare fino a 20 webhook in entrata nel tuo account Brevo. Per aggiungere un nuovo webhook oltre questo limite, eliminane uno esistente.
• L'URL di ciascun webhook può gestire fino a 20 eventi al secondo.
• Al momento, puoi recuperare i dati solo dal primo livello gerarchico del payload JSON. Ciò significa che puoi accedere direttamente agli array e agli oggetti di primo livello, ma non puoi recuperare i dati da array nidificati o da livelli inferiori.
• Se vuoi creare webhook in uscita per inviare dati in tempo reale da Brevo a un'app esterna, consulta il nostro articolo dedicato Nuovi webhook - Creazione di webhook in uscita per inviare dati in tempo reale da Brevo a un'app esterna.

Fase 1: creazione di un webhook in entrata in Brevo

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

1. In Brevo, clicca sul menu a discesa dell'account e seleziona Integrations (Integrazioni).
2. Vai alla scheda Webhooks (Webhook).
3. Clicca su Add webhook (Aggiungi webhook).
   
4. Seleziona Inbound webhook (Webhook in entrata).
5. Clicca su Add webhook (Aggiungi webhook).
   

Fase 2: configurazione del webhook in entrata in Brevo

Quindi, configura il webhook in entrata in Brevo.

1. Dai un nome al webhook.
   
2. Clicca su Continue (Continua).
3. Seleziona il metodo HTTP che vuoi utilizzare per questo webhook (POST, GET, PUT o PATCH).
4. Copia l'URL del webhook generato da Brevo. Questo URL di callback indica all'app esterna dove inviare il webhook in entrata quando si verifica un evento.
   
5. Incolla l'URL del webhook nella tua app esterna. Questo di solito viene fatto da una pagina di configurazione del webhook, da una sezione di automazione o tramite un'integrazione API.
   
   💡 Buono a sapersi

   Se non sai dove incollare l'URL del webhook, consulta il centro assistenza della tua app esterna o contatta il relativo team di assistenza.
6. (Opzionale) Per aggiungere un ulteriore livello di sicurezza o se la tua app esterna lo richiede:
   1. Attiva l'opzione Require authentication (Richiedi autenticazione).
   2. Copia il token generato da Brevo.
      
      
      💡 Buono a sapersi

      Se il token è compromesso, puoi rigenerarlo cliccando sull'icona di aggiornamento 🔄 e aggiornarlo nella tua app esterna.
   3. Incolla il token nella tua app esterna.
7. Finisci di configurare il webhook in entrata nella tua app esterna. Ti potrebbe venire chiesto di selezionare:
   • L'evento che attiverà il webhook.
   • I dati da includere nel payload.

Fase 3: invio di una richiesta di test e scelta del payload da sincronizzare

Prova il webhook in entrata e conferma i dati dell'evento ricevuti.

1. Invia una richiesta di test dalla tua app esterna a Brevo. 
2. Verifica i dati dell'evento ricevuti per assicurarti che contengano tutti i parametri che vuoi sincronizzare. Se mancano delle informazioni, invia ulteriori richieste di test finché non ricevi il payload corretto.
   
3. (Opzionale) Se sono state inviate più richieste di test:
   1. Clicca su 🔄 Reload (Ricarica).
   2. Utilizza il menu a discesa per selezionare il payload desiderato tra gli ultimi 10 payload ricevuti.
      
4. Clicca su Continue (Continua).

Fase 4: configurazione dell'azione attivata dal webhook in ingresso

Configura l'azione da attivare in Brevo quando viene ricevuto il webhook. Ciò comporta l'abbinamento delle chiavi di payload (i dati dell'evento ricevuti nel webhook in entrata) agli attributi Brevo per garantire che i dati in entrata siano formattati correttamente e attivino l'azione corretta.

Puoi scegliere tra due azioni disponibili:

• Opzione 1: crea un evento
  Tieni traccia delle azioni esterne in Brevo creando un evento personalizzato.
• Opzione 2: crea o aggiorna un contatto
  Aggiungi o aggiorna automaticamente i dati del contatto in Brevo.

Dopo l'attivazione, il webhook in entrata invierà i dati dalla tua app esterna a Brevo ogni volta che viene attivato. Puoi quindi utilizzare i dati ricevuti per eseguire diverse azioni, ad esempio:

• Segmentazione dei contatti in base ai dati dell'evento.
• Attivazione delle automazioni tramite eventi personalizzati.
• Personalizzazione di email, SMS o altri messaggi.

Esame dei log del webhook in entrata per la risoluzione dei problemi

Ogni volta che viene attivato un webhook in entrata, questo invia i dati dalla tua app esterna a Brevo, dove vengono elaborate le azioni del webhook. Puoi esaminare i log di un webhook in entrata per verificare se le azioni sono state eseguite correttamente e identificare eventuali problemi da risolvere.

1. In Brevo, clicca sul menu a discesa dell'account e seleziona Integrations (Integrazioni).
2. Vai alla scheda Webhooks (Webhook).
3. Seleziona l'opzione Inbound webhook (Webhook in entrata). Qui troverai una panoramica delle azioni elaborate nelle ultime 24 ore e il relativo stato per ogni webhook in entrata:
   
   • Mapped (Abbinata): l'azione è stata elaborata correttamente.
   • Not mapped (Non abbinata): si è verificato un errore e l'azione non è stata elaborata.
     
4. Clicca sul nome del webhook in entrata per accedere ai relativi log.
5. Nella scheda Logs (Log), esamina i log del webhook in entrata:
   
   
   1. Filter by status (Filtra per stato): consente di visualizzare tutte le azioni, solo le azioni abbinate o quelle non abbinate.
   2. Refresh logs (Aggiorna log): ottieni i dati più recenti in tempo reale.
   3. Visualizza le chiamate dei webhook in entrata: esamina il timbro data/ora e il payload elaborato per ogni chiamata di webhook.
   4. Esamina le azioni elaborate e gli attributi: scopri quali azioni ha gestito Brevo dopo aver ricevuto un webhook in entrata e controlla i dati trasferiti per ogni azione. Se si verifica un errore, confronta il tipo di chiave prevista con il valore ricevuto.

Disattivazione di un webhook in entrata

Se devi interrompere temporaneamente la ricezione di dati dalla tua app esterna, puoi disattivare il webhook in entrata.

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

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

Eliminazione di un webhook in entrata

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

1. In Brevo, clicca sul menu a discesa dell'account e seleziona Integrations (Integrazioni).
2. Vai alla scheda Webhooks (Webhook).
3. Seleziona l'opzione Inbound webhook (Webhook in entrata).
4. Accanto al webhook in entrata che vuoi eliminare, clicca sull'icona del cestino.
   
5. Clicca su Delete webhook (Elimina webhook) per confermare.

Il webhook in entrata e l'URL di callback associato sono stati eliminati definitivamente.

⏭️ E adesso?

• Nuovi webhook - Creazione di webhook in uscita per inviare dati in tempo reale da Brevo a un'app esterna
• Invio di webhook in uscita da un'automazione

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