Guida Tecnica

Cosa sono i webhook

Un webhook è un'API al contrario: invece di chiedere continuamente "ci sono novità?", è il servizio che ti avvisa quando succede qualcosa. Un pagamento ricevuto, un messaggio WhatsApp, un pacco consegnato. È il meccanismo che rende possibili le automazioni in tempo reale.

Blog Contat7 min di lettura

Notifica, non richiesta

Con un'API chiedi tu i dati; con un webhook è il servizio che te li manda appena l'evento accade. Da pull a push.

Tempo reale

Niente controlli ogni 5 minuti: la notifica parte nell'istante in cui succede qualcosa. Fondamentale per pagamenti e ordini.

Un semplice URL

Tecnicamente un webhook è solo un indirizzo del tuo sistema a cui il servizio esterno invia una richiesta HTTP con i dati dell'evento.

Colla delle automazioni

Zapier, Make, n8n e le automazioni custom si reggono sui webhook: ogni evento può innescare una catena di azioni.

Verificabili

I webhook seri sono firmati: il tuo sistema verifica che la notifica arrivi davvero dal servizio e non da un impostore.

Efficienti

Niente migliaia di richieste a vuoto per controllare se c'è qualcosa di nuovo: si consuma banda e calcolo solo quando serve.

Un webhook in 4 passaggi

Dalla registrazione dell'indirizzo alla reazione automatica: il ciclo di vita di una notifica webhook.

01

Registri l'indirizzo di ascolto

Nel pannello del servizio (Stripe, Shopify, WhatsApp Business…) configuri l'URL del tuo sistema, ad esempio tuosito.it/api/webhook/pagamenti, e scegli quali eventi ti interessano: pagamento riuscito, ordine creato, messaggio ricevuto.

02

L'evento accade

Un cliente paga, un pacco viene consegnato, arriva un messaggio. Il servizio esterno registra l'evento nei propri sistemi e prepara la notifica con tutti i dati rilevanti, quasi sempre in formato JSON.

03

Il servizio chiama il tuo URL

Parte una richiesta HTTP POST verso il tuo indirizzo con i dati dell'evento e una firma di sicurezza. Se il tuo sistema non risponde, i servizi ben fatti ritentano più volte con attese crescenti: nessun evento va perso.

04

Il tuo sistema reagisce

Ricevuta e verificata la notifica, il tuo software agisce: segna l'ordine come pagato, invia l'email di conferma, aggiorna il magazzino, avvisa il team su WhatsApp. Tutto in automatico, in meno di un secondo dall'evento.

Il webhook come campanello tra sistemi
Il webhook come campanello tra sistemi

Il campanello, non la ronda

Immagina di aspettare un pacco. Puoi affacciarti alla finestra ogni cinque minuti per vedere se è arrivato il corriere — stancante e inefficiente — oppure puoi contare sul campanello: quando il corriere arriva, suona, e tu reagisci. Il webhook è il campanello: un meccanismo con cui un servizio esterno avvisa il tuo sistema nel momento esatto in cui accade un evento.

Se hai letto la nostra guida Cosa sono le API, il quadro è questo: l'API classica è una conversazione che inizi tu (chiedi e ricevi), il webhook è una conversazione che inizia l'altro (ti avvisa e tu reagisci). Le due cose lavorano quasi sempre insieme: il webhook ti dice che è successo qualcosa, e spesso il tuo sistema richiama l'API per avere i dettagli completi.

Polling inefficiente contro push istantaneo
Polling inefficiente contro push istantaneo

Webhook vs polling: perché il push vince

L'alternativa al webhook si chiama polling: il tuo sistema interroga l'API del servizio a intervalli regolari — "novità? novità? novità?" — anche quando non c'è niente di nuovo. Funziona, ma ha costi reali:

  • Ritardo: se controlli ogni 5 minuti, in media scopri l'evento dopo 2 minuti e mezzo. Per un pagamento o una prenotazione è un'eternità.
  • Spreco: il 99% delle richieste torna a mani vuote, consumando banda, calcolo e quota di rate limit.
  • Complessità: devi ricordarti cosa hai già visto per non processare due volte lo stesso evento.

Il webhook ribalta il modello: zero richieste a vuoto, latenza di frazioni di secondo, un solo punto di ingresso da gestire. Il prezzo da pagare è che il tuo sistema deve esporre un endpoint pubblico, sicuro e sempre disponibile — ed è qui che serve un lavoro fatto bene.

Con il polling chiedi mille volte "è successo qualcosa?". Con un webhook te lo dicono una volta sola: quando è successo davvero.

Integrazioni in tempo reale
Webhook nella vita di un'attività online
Webhook nella vita di un'attività online

Esempi concreti: i webhook che usi già oggi

Se hai un'attività online, i webhook lavorano già per te:

  • Pagamenti: quando Stripe o PayPal completano un incasso, un webhook avvisa il tuo e-commerce, che segna l'ordine pagato e manda la conferma al cliente.
  • WhatsApp Business: ogni messaggio in arrivo è un webhook verso il tuo gestionale o il tuo chatbot, che può rispondere all'istante.
  • Spedizioni: il corriere notifica i cambi di stato (in transito, in consegna, consegnato) e il cliente riceve l'aggiornamento senza che nessuno controlli nulla a mano.
  • Moduli e CRM: il form compilato sul sito innesca un webhook che crea il contatto nel CRM e avvisa il commerciale.
  • Calendari e prenotazioni: la prenotazione confermata fa partire promemoria, fattura e blocco disponibilità.

Sono gli stessi mattoni che usiamo nei progetti di bot e automazione: l'evento innesca, l'automazione esegue.

Firma, deduplica e code: webhook fatti bene
Firma, deduplica e code: webhook fatti bene

Sicurezza e affidabilità: i dettagli che fanno la differenza

Un endpoint webhook è una porta aperta sul tuo sistema: chiunque conosca l'URL può bussare. Un'implementazione professionale prevede sempre:

  • Verifica della firma: i servizi seri firmano ogni notifica (tipicamente HMAC). Il tuo endpoint ricalcola la firma e scarta tutto ciò che non corrisponde.
  • Idempotenza: la stessa notifica può arrivare due volte (i retry esistono apposta). Il sistema deve riconoscere i duplicati e processare l'evento una volta sola — nessuno vuole due email di conferma o due scarichi di magazzino.
  • Risposta rapida: l'endpoint conferma subito la ricezione e fa il lavoro pesante dopo, in coda. Se rispondi lento, il mittente pensa che tu sia giù e ritenta.
  • Monitoraggio: un webhook che smette di arrivare non fa rumore — te ne accorgi dai clienti arrabbiati. Serve chi controlla che tutto giri.

Webhook nella tua azienda: da dove iniziare

La domanda giusta non è "mi serve un webhook?" ma "quali eventi della mia attività dovrebbero innescare qualcosa in automatico?". Un ordine pagato, una prenotazione, un modulo compilato, un reso: ogni evento che oggi qualcuno gestisce a mano copiando dati da una parte all'altra è un candidato.

Il nostro approccio: mappiamo gli eventi, scegliamo per ciascuno il meccanismo giusto (webhook nativo del servizio, polling dove il webhook non esiste, coda interna per i volumi alti) e costruiamo automazioni che non perdono colpi. E se il tuo sito ha già integrazioni che nessuno controlla più, con l'assistenza sito web le verifichiamo e le rimettiamo in sesto. Per il quadro completo su come i software si parlano, riparti da Cosa sono le API; se ti interessa il lato AI, leggi Cosa sono gli MCP.

Domande frequenti sui webhook

È una notifica automatica tra software: quando su un servizio accade un evento (un pagamento, un messaggio, una consegna), il servizio chiama un indirizzo del tuo sistema e gli consegna i dati dell'evento. Tu non chiedi: vieni avvisato.
Direzione opposta. Con un'API è il tuo software a fare la richiesta quando gli serve (pull); con un webhook è il servizio esterno che ti contatta quando succede qualcosa (push). Nelle integrazioni reali si usano insieme: il webhook avvisa, l'API approfondisce.
Sì, se implementato bene: firma crittografica verificata su ogni notifica, HTTPS obbligatorio, gestione dei duplicati e URL non indovinabile. Un endpoint webhook scritto male, invece, è una porta aperta: chiunque potrebbe inviarti eventi falsi.
I servizi ben fatti ritentano la consegna più volte con attese crescenti (retry con backoff), per ore o giorni. Ma non tutti lo fanno allo stesso modo: per eventi critici come i pagamenti si aggiunge una riconciliazione periodica via API che recupera ciò che si fosse perso.
In parte sì: piattaforme come Zapier, Make o n8n ricevono webhook e innescano azioni senza codice. Per flussi critici, volumi alti o logiche personalizzate serve però un endpoint sviluppato su misura, con firma, code e monitoraggio.
Noi. Con il servizio di assistenza sito web colleghiamo pagamenti, WhatsApp, corrieri e CRM al tuo sito: configurazione, test, sicurezza e monitoraggio continuo. La prima consulenza è gratuita.

Vuoi automatizzare con i webhook?

Colleghiamo pagamenti, messaggi, spedizioni e CRM al tuo sito con endpoint sicuri e monitorati. Dall'analisi degli eventi alla messa in produzione.

Ultimo aggiornamento: