n8n tutorial italiano: da zero al primo workflow in produzione

Questo n8n tutorial italiano ti porta da zero a un workflow reale pronto per la produzione. L'obiettivo non è solo cliccare qualche nodo: è capire come costruire una automazione che puoi lasciare accesa senza controllarla ogni ora.

Useremo un caso semplice ma utile: un form contatto che crea un lead, lo salva e invia una notifica al team.

Se vuoi una versione ancora più rapida, leggi anche il tuo primo workflow n8n in 5 minuti. Qui invece andiamo più in profondità.

Cosa imparerai in questo tutorial n8n?

Alla fine avrai capito:

• cosa sono workflow, trigger e nodi
• come far entrare dati in n8n
• come validare campi importanti
• come salvare dati in un foglio o CRM
• come inviare una notifica
• come testare un workflow
• cosa controllare prima di attivarlo in produzione

Secondo la documentazione ufficiale, un workflow n8n è una raccolta di nodi collegati tra loro per automatizzare un processo. Puoi usare template, creare workflow da zero e fare debug tramite le esecuzioni. Riferimento: n8n workflows.

Prima di iniziare: cloud o self-hosted?

Hai due strade.

La prima è n8n Cloud: più semplice da avviare, hosting gestito, meno lavoro tecnico.

La seconda è n8n self-hosted: più controllo, dati sulla tua infrastruttura, costi prevedibili, ma richiede manutenzione.

Per imparare, entrambe vanno bene. Per un'azienda, la scelta dipende da dati, budget, competenze e criticità dei workflow. Se vuoi capire i costi reali, leggi il costo reale di n8n self-hosted.

Step 1: crea un nuovo workflow

Apri n8n e crea un nuovo workflow.

Dagli subito un nome chiaro, per esempio:

Lead form -> CRM -> notifica commerciale

Un nome utile deve dire:

• da dove partono i dati
• cosa fa il workflow
• qual è il risultato finale

Evita nomi come "Test 1" o "Workflow nuovo". Dopo 20 automazioni diventano ingestibili.

Step 2: scegli il trigger

Il trigger è il punto di ingresso.

Per questo tutorial puoi usare un Webhook Trigger. È adatto quando vuoi ricevere dati da:

• form del sito
• landing page
• app interna
• integrazione custom
• sistema esterno che può chiamare un URL

Nel nodo Webhook imposta:

• metodo: POST
• path: qualcosa come lead-form
• risposta: conferma JSON semplice

Esempio di payload atteso:

{
  "nome": "Mario Rossi",
  "email": "[email protected]",
  "azienda": "Rossi SRL",
  "messaggio": "Vorrei automatizzare la gestione dei lead."
}

Step 3: testa il trigger con dati realistici

Non testare con dati finti come [email protected] e ciao.

Usa esempi realistici:

• email valida
• azienda plausibile
• messaggio lungo
• campi mancanti
• caratteri accentati
• telefono con prefisso italiano

Questo ti aiuta a scoprire problemi prima della produzione.

La documentazione n8n distingue esecuzioni manuali e di produzione. Le esecuzioni manuali servono per testare dal canvas; le esecuzioni di produzione partono automaticamente quando il workflow è attivo. Vedi manual and production executions.

Step 4: valida i dati obbligatori

Aggiungi un nodo IF o Code per controllare i campi minimi:

• email presente
• email con formato valido
• messaggio non vuoto
• consenso privacy se richiesto dal form

Esempio logico:

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 }];

In produzione, un errore chiaro vale più di un workflow che prosegue con dati sporchi.

Step 5: normalizza i dati

Prima di salvare nel CRM o nel foglio, normalizza.

Esempi:

• email in minuscolo
• nome senza spazi doppi
• telefono ripulito
• azienda con capitalizzazione coerente
• sorgente lead impostata a sito web

Esempio:

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()
  }
}];

Step 6: salva il lead

Per iniziare puoi usare Google Sheets. Per un processo commerciale maturo, meglio un CRM.

Opzione semplice:

• Google Sheets: aggiungi una riga con nome, email, azienda, messaggio, data

Opzione professionale:

• HubSpot o Pipedrive: crea o aggiorna contatto
• crea deal se il messaggio è commerciale
• assegna owner
• salva sorgente e campagna

Se il tuo obiettivo è vendite, il CRM deve essere il sistema principale. Il foglio può restare solo come log o backup.

Approfondimento: automatizzare Google Sheets con n8n.

Step 7: invia la notifica

La notifica deve essere breve e utile.

Esempio Telegram o Slack:

Nuovo lead da n8n.it

Nome: Mario Rossi
Azienda: Rossi SRL
Email: [email protected]
Messaggio: Vorrei automatizzare la gestione dei lead.

Aggiungi anche link diretto al CRM o al foglio. Il team non deve cercare il lead a mano.

Step 8: gestisci errori e fallback

Un workflow tutorial funziona quando tutto va bene. Un workflow professionale funziona anche quando qualcosa va male.

Prevedi:

• errore CRM
• Google Sheets non disponibile
• payload incompleto
• API rate limit
• notifica non inviata

In n8n puoi usare error workflow e nodi dedicati per catturare problemi. Per workflow critici, crea un canale alert separato: non mescolare incidenti operativi e chat normale.

Leggi anche i 7 errori più comuni con n8n in produzione.

Step 9: controlla le esecuzioni

Ogni run di un workflow è una esecuzione. Dalla lista esecuzioni puoi vedere:

• stato: successo, errore, running, waiting
• nodo in cui si è fermato
• input e output
• tempo di esecuzione

La documentazione ufficiale spiega che le esecuzioni permettono anche debug e retry dei workflow falliti. Vedi workflow-level executions.

Step 10: pubblica e attiva il workflow

Prima di attivare, fai questa checklist:

• il workflow ha un nome chiaro
• i nodi principali hanno nomi comprensibili
• le credenziali non sono condivise in modo improprio
• hai testato almeno 5 payload realistici
• sai cosa succede se il CRM non risponde
• hai una notifica sugli errori
• hai deciso dove conservare i log

Poi pubblica e attiva il workflow.

n8n salva le modifiche mentre lavori, ma la pubblicazione rende live una versione del workflow. La documentazione ufficiale su save and publish è utile per capire la differenza tra lavoro in bozza e workflow in produzione.

Quali errori evitare nel primo workflow n8n?

Errore 1: partire da un workflow troppo grande

Non creare subito un sistema completo con form, CRM, email, AI, WhatsApp, fatturazione e report.

Costruisci prima:

form -> salvataggio -> notifica

Poi aggiungi scoring, AI, follow-up e report.

Errore 2: non validare l'input

Se lasci entrare dati sporchi, prima o poi sporchi CRM e report.

Errore 3: non gestire duplicati

Prima di creare un nuovo contatto, cerca se l'email esiste già.

Errore 4: non distinguere test e produzione

Usa nomi, credenziali e canali diversi. Un messaggio test nel canale commerciale crea confusione.

Errore 5: non avere alert sugli errori

Un workflow silenzioso è pericoloso. Se fallisce, devi saperlo.

Cosa imparare dopo questo tutorial?

Dopo il primo workflow, studia questi temi:

• credenziali e sicurezza
• webhook pubblici e rate limit
• retry e error handling
• gestione esecuzioni
• backup self-hosted
• AI Agent con strumenti controllati

Per la parte sicurezza, parti da come mettere in sicurezza n8n esposto su internet.

Quando passare a una consulenza?

Puoi continuare da solo se stai automatizzando processi interni non critici.

Ha senso chiedere supporto se:

• il workflow gestisce lead o pagamenti
• l'istanza n8n è esposta su internet
• hai dati personali o clienti
• vuoi usare n8n self-hosted in produzione
• vuoi evitare errori di backup, TLS e credenziali

In quel caso parti da setup n8n o supporto n8n.

Conclusione

Il primo workflow n8n non deve essere perfetto. Deve essere piccolo, utile e controllabile.

Se impari subito trigger, validazione, salvataggio, notifica, errori ed esecuzioni, hai già le basi per costruire automazioni più robuste.