Cos'è un Webhook? Una guida completa per principianti

Sviluppare moderne applicazioni web significa far comunicare tra loro sistemi diversi. Quando ricevi un pagamento da un sito di e-commerce, una notifica automatica va alla tua compagnia di spedizioni, o quando un utente si registra, cade nel tuo sistema CRM… L’eroe nascosto dietro tutti questi scenari è solitamente la tecnologia Webhook.

Cos’è un Webhook?

Nella sua definizione più semplice, un Webhook è un modo per trasmettere dati in tempo reale da un’applicazione all’altra. È anche chiamato “Callback HTTP definito dall’utente”.

Quando si verifica un evento (ad esempio: “nuovo ordine arrivato”), l’applicazione sorgente invia dati a un URL (Endpoint) determinato dall’applicazione di destinazione. Questi dati sono solitamente in formato JSON o XML.

Puoi paragonare i webhook alle notifiche SMS sul tuo telefono. Invece di aprire costantemente l’app per chiedere “c’è un nuovo messaggio?” (Polling), il tuo telefono vibra quando arriva un messaggio e vedi la notifica.

Webhook vs Polling: Qual è la differenza?

Nei metodi API tradizionali (Polling), il client chiede al server a determinati intervalli:

• Client: Ci sono nuovi dati?
• Server: No.
• (5 secondi dopo)
• Client: Ci sono nuovi dati?
• Server: No.
• (5 secondi dopo)
• Client: Ci sono nuovi dati?
• Server: Sì, ecco i dati.

Questo metodo consuma inutilmente risorse del server e crea latenza nell’accesso ai dati.

Nel Metodo Webhook:

• Server: Ehi Client! Sono stati creati nuovi dati, eccoli! (Invia richiesta HTTP POST)

In questo modo, i dati vengono trasmessi istantaneamente e non viene creato traffico inutile.

Come funziona un Webhook?

1. Evento Scatenante (Trigger): Si verifica un evento nel sistema sorgente (es. il pagamento è andato a buon fine in Stripe).
2. Richiesta HTTP: Il sistema sorgente invia una richiesta HTTP POST all’URL predefinito.
3. Payload: Il corpo di questa richiesta contiene dettagli sull’evento (es. Importo del pagamento, ID cliente).
4. Elaborazione: Il sistema di destinazione riceve questa richiesta, la verifica (verifica di sicurezza) ed esegue la propria logica aziendale.

Casi d’uso Webhook

• Sistemi di Pagamento: Ricezione della conferma di pagamento da sistemi come Stripe, PayPal.
• Processi CI/CD: Avvio di test automatici quando il codice viene inviato a GitHub.
• Comunicazione: Invio di messaggi a bot Slack o Discord.
• E-Commerce: Aggiornamento dell’inventario quando viene creato un ordine in Shopify.

Conclusione

I webhook sono la pietra miliare delle moderne architetture guidate dagli eventi (event-driven). Accelerano l’integrazione tra i sistemi, riducono l’utilizzo delle risorse e ti consentono di offrire esperienze in tempo reale.

Se lavori con i webhook, monitorare e gestire queste richieste può essere difficile. È esattamente qui che entra in gioco WebhookIO; ti consente di monitorare, eseguire il debug e gestire in sicurezza il traffico webhook.