Tutorial completo · gratuito
Tutorial n8n in italiano: da zero al primo workflow in produzione
Non il solito giro turistico di qualche nodo: alla fine di questa pagina avrai un workflow vero, testato e attivo, costruito come lo costruiremmo per un cliente. Tutto gratis, tutto copiabile.
45-60 min
per completarlo
Da zero
nessun prerequisito
11 step
più checklist finale
Gratuito
senza registrazione
Il progetto
Cosa costruirai
Un workflow di gestione lead completo: un form contatto che valida i dati, li salva su CRM o foglio e avvisa il commerciale in tempo reale. È il primo workflow che consigliamo a ogni azienda: semplice, utile da subito e facile da verificare.
Se n8n è una novità assoluta, prima di partire leggi cos'è n8n: cinque minuti e torni qui con il contesto giusto.
Installa n8n: due strade, entrambe valide
n8n Cloud: ti registri su n8n.io e in pochi minuti hai un editor funzionante. Perfetto per imparare senza toccare server.
Self-hosted con Docker: un comando e n8n gira sulla tua macchina, sulla porta 5678. È la strada che ti fa capire da subito come funziona davvero:
terminale
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-v ~/.n8n:/home/node/.n8n \
n8nio/n8nPer il tutorial vanno bene entrambe. Per un uso aziendale la scelta dipende da dati, budget e criticità: i costi veri sono analizzati in quanto costa davvero n8n self-hosted. Attenzione: questo comando è per imparare in locale, non per la produzione. Un'istanza esposta su internet richiede TLS, autenticazione e backup: ne parliamo allo step 10.
Crea il workflow e dagli un nome serio
Crea un nuovo workflow e chiamalo subito con un nome che dica da dove partono i dati, cosa succede e qual è il risultato:
Lead form -> CRM -> notifica commercialeSembra pignoleria, non lo è: dopo venti automazioni, i workflow chiamati "Test 1" e "Workflow nuovo" diventano un campo minato. La disciplina sui nomi è la prima differenza tra chi gioca e chi va in produzione.
Scegli il trigger: il Webhook
Il trigger è il punto di ingresso del workflow. Per questo progetto usa un Webhook Trigger: riceve dati da form del sito, landing page, app interne o qualunque sistema capace di chiamare un URL.
- Metodo: POST
- Path: qualcosa di parlante, per esempio lead-form
- Risposta: una conferma JSON semplice
Il payload che il webhook si aspetta di ricevere:
json in ingresso
{
"nome": "Mario Rossi",
"email": "[email protected]",
"azienda": "Rossi SRL",
"messaggio": "Vorrei automatizzare la gestione dei lead."
}Testa il trigger con dati realistici
Il test con [email protected] e "ciao" non conta. I problemi veri escono con i dati veri:
- un'email valida e una malformata
- un messaggio lungo e uno vuoto
- campi mancanti
- caratteri accentati (à, è, ù: in Italia arrivano sempre)
- un telefono con prefisso internazionale
In n8n le esecuzioni manuali servono proprio a questo: provi dal canvas, guardi cosa entra ed esce da ogni nodo, e scopri i problemi prima che li scopra un cliente.
Valida i dati obbligatori
Aggiungi un nodo Code (o un IF) che blocca i dati inutilizzabili prima che sporchino il CRM. In produzione un errore chiaro vale più di un workflow che prosegue con dati rotti:
nodo code · validazione
const item = $input.first().json;
if (!item.email || !item.email.includes("@")) {
throw new Error("Email mancante o non valida");
}
if (!item.messaggio || item.messaggio.length < 10) {
throw new Error("Messaggio troppo breve");
}
return [{ json: item }];Se il form richiede il consenso privacy, validalo qui: un lead senza consenso non deve arrivare nel CRM.
Normalizza prima di salvare
Email in minuscolo, spazi ripuliti, sorgente del lead impostata: trenta secondi di lavoro adesso, ore di pulizia dati risparmiate tra sei mesi.
nodo code · normalizzazione
const lead = $input.first().json;
return [{
json: {
nome: String(lead.nome || "").trim(),
email: String(lead.email || "").trim().toLowerCase(),
azienda: String(lead.azienda || "").trim(),
messaggio: String(lead.messaggio || "").trim(),
sorgente: "sito web",
ricevuto_il: new Date().toISOString()
}
}];Salva il lead: foglio o CRM
Per iniziare: Google Sheets, una riga per lead con nome, email, azienda, messaggio e data. Zero attrito, e la guida completa è in n8n e Google Sheets.
Per un processo commerciale vero: un CRM come HubSpot o Pipedrive. Crea o aggiorna il contatto, apri un deal se il messaggio è commerciale, assegna un owner e salva sorgente e campagna. Il foglio può restare come log di backup, ma il CRM deve essere il sistema principale.
Invia la notifica al team
Breve e azionabile, su Telegram o Slack. Il commerciale deve poter agire dal telefono, non cercare il lead a mano:
messaggio di notifica
Nuovo lead dal sito
Nome: Mario Rossi
Azienda: Rossi SRL
Email: [email protected]
Messaggio: Vorrei automatizzare la gestione dei lead.
-> Apri nel CRM: [link diretto al contatto]Gestisci errori e fallback
Un workflow da tutorial funziona quando va tutto bene. Un workflow professionale funziona anche quando va male. Chiediti cosa succede se:
- il CRM è giù o risponde con un errore
- Google Sheets non è raggiungibile
- il payload arriva incompleto
- un'API ti mette in rate limit
- la notifica stessa non parte
In n8n la risposta è l'error workflow: un workflow separato che scatta quando un altro fallisce e manda l'alert in un canale dedicato agli incidenti, separato dalla chat normale. I casi che vediamo più spesso andare storti sono raccolti in i 7 errori più comuni con n8n in produzione.
Impara a leggere le esecuzioni
Ogni run del workflow è un'esecuzione, e la lista esecuzioni è il tuo pannello di controllo: stato (successo, errore, in corso), nodo esatto dove il flusso si è fermato, input e output di ogni passaggio, tempo impiegato. È anche il posto da cui rilanciare le esecuzioni fallite dopo aver corretto il problema. Dieci minuti passati qui valgono più di un'ora di documentazione.
Pubblica e attiva: la checklist di produzione
Prima di attivare il workflow, passa questa checklist. È la versione ridotta di quella che usiamo sui progetti veri:
- Il workflow ha un nome chiaro e i nodi principali sono rinominati
- Le credenziali sono dedicate, non condivise tra test e produzione
- Hai testato almeno 5 payload realistici, inclusi campi mancanti e accenti
- Sai cosa succede se il CRM non risponde (e il workflow non muore in silenzio)
- Hai un alert sugli errori in un canale separato da quello commerciale
- Hai deciso dove vivono i log e per quanto tempo
- Duplicati gestiti: prima di creare un contatto cerchi se l'email esiste già
La versione completa, con i controlli su server, TLS, backup e monitoraggio, è il Production Playbook: 27 controlli, gratuito.
Poi salva, pubblica e attiva: da questo momento il webhook è vivo e le esecuzioni partono da sole. Benvenuto in produzione.
Esperienza sul campo
I 5 errori del primo workflow
- Partire troppo in grande. Prima form, salvataggio, notifica. Poi scoring, AI e follow-up. Non il contrario.
- Non validare l'input. I dati sporchi entrano una volta e li ritrovi nei report per anni.
- Ignorare i duplicati. Prima di creare un contatto, cerca se l'email esiste già nel CRM.
- Mischiare test e produzione. Nomi, credenziali e canali separati. Un messaggio di test nel canale commerciale brucia la fiducia del team.
- Nessun alert sugli errori. Un workflow che fallisce in silenzio è più pericoloso di uno che non esiste.
Il percorso continua
Cosa studiare dopo questo tutorial
FAQ
Domande frequenti sul tutorial
Esiste un tutorial n8n in italiano per principianti?
Sì: questo tutorial di n8n.it è gratuito e in italiano, e guida passo passo dall'installazione al primo workflow reale in produzione: trigger, validazione dei dati, salvataggio su CRM o foglio, notifiche, gestione errori, test e checklist finale di pubblicazione.
Quanto tempo serve per completare il tutorial?
Per costruire il workflow del tutorial bastano 45-60 minuti. Per portarlo in produzione in modo affidabile aggiungi il tempo per test con dati realistici, gestione degli errori e credenziali sicure: è la parte che distingue un esperimento da un'automazione su cui puoi contare.
Qual è il miglior primo workflow n8n da costruire?
Un flusso form contatto, validazione, salvataggio su foglio o CRM, notifica al team: è semplice, utile da subito e facile da verificare. È esattamente il workflow costruito in questo tutorial, ed è la base su cui poi aggiungere qualifica AI, follow-up e report.
Meglio imparare n8n su Cloud o self-hosted?
Per imparare vanno bene entrambi: n8n Cloud si attiva in minuti, il self-hosted con Docker richiede un comando ma ti fa capire da subito come funziona davvero. Per un uso aziendale la scelta dipende da dati, budget e criticità: la guida di n8n.it su cos'è n8n confronta le due strade in dettaglio.
Serve saper programmare per seguire questo tutorial?
No: quasi tutto si fa dall'editor visuale. I due snippet JavaScript del tutorial (validazione e normalizzazione) si copiano e incollano nel nodo Code e sono spiegati riga per riga. Saper leggere un minimo di codice aiuta, ma non è un prerequisito.
Come si pubblica un workflow n8n?
Dopo i test si salva, si pubblica e si attiva: da quel momento le esecuzioni partono automaticamente dal trigger. Prima di attivare conviene passare una checklist di produzione: nomi chiari, credenziali dedicate, test realistici, alert sugli errori e gestione dei duplicati.
Quando serve una mano
Il primo workflow è tuo. I prossimi venti, se vuoi, li costruiamo insieme
Continua da solo finché automatizzi processi interni non critici. Quando in gioco ci sono lead, pagamenti, dati personali o un'istanza esposta su internet, una valutazione tecnica costa un'email e rispondiamo entro 24 ore lavorative.