Il termine indica un meccanismo semplice: un sistema espone un indirizzo web e un altro sistema, quando si verifica un certo evento, gli invia una richiesta HTTP con i dati di quell’evento. Il caso tipico è un modulo compilato sul sito, un ordine confermato nell’e-commerce o un pagamento registrato. Invece di interrogare la fonte ogni pochi minuti per sapere se c’è qualcosa di nuovo, aspetti che sia lei ad avvisarti.
Come funziona
Chi riceve il webhook deve essere raggiungibile da internet e rispondere alla chiamata, mentre chi lo invia di solito trasmette un JSON con i campi dell’evento. Prima di metterlo in produzione conviene decidere alcuni aspetti:
- quale evento scatena la chiamata e quali dati porta con sé;
- come il ricevente verifica che la chiamata arrivi dal mittente atteso e non da chiunque conosca l’indirizzo;
- cosa succede se il ricevente in quel momento è irraggiungibile, perché non tutti i mittenti ritentano l’invio.
Un esempio in azienda
Un costruttore di macchine per l’imballaggio raccoglie le richieste di preventivo con un modulo sul sito. Al momento dell’invio il modulo chiama un webhook e il workflow che lo riceve crea il contatto nel CRM, assegna la richiesta al commerciale di zona in base alla provincia e avvisa l’ufficio tecnico se nelle note compare un codice macchina. Tutto avviene in pochi secondi e il commerciale non deve più copiare i dati dalla casella email.
In n8n
In n8n il nodo Webhook è un nodo trigger: riceve i dati inviati da app e servizi quando si verifica un evento e avvia il workflow. Ogni nodo ha due indirizzi distinti, uno di test, attivo quando ascolti un evento di prova dall’editor, e uno di produzione, registrato quando pubblichi il workflow; le chiamate di produzione non compaiono nell’editor ma nell’elenco delle esecuzioni. Puoi richiedere autenticazione Basic, tramite header o JWT, limitare gli indirizzi IP ammessi e scegliere se rispondere subito al chiamante, quando termina l’ultimo nodo oppure con un nodo Respond to Webhook dedicato. Il payload massimo indicato dalla documentazione è di 16 MB.
Se vuoi collegare sito, gestionale e CRM con flussi che partono dagli eventi reali, trovi come lavoriamo nella pagina dedicata alle automazioni per le PMI.
Automazioni e integrazioni tra gestionale, CRM e strumenti che già usate.
Raccontaci il processoVoce aggiornata il · Torna al glossario