n8n: Da Zero al Primo Workflow in 30 Minuti

n8n è una piattaforma di automazione open-source che ti permette di connettere app, servizi e API senza scrivere codice — o scrivendone poco, solo dove serve davvero. È la mia scelta principale per workflow aziendali: self-hostable (i dati restano tuoi, non su un server di terzi), potente, con 400+ integrazioni native e la possibilità di inserire nodi di codice JavaScript o Python quando la logica visuale non basta.

In questa guida costruiamo insieme il tuo primo workflow reale — non un "hello world" astratto, ma un caso concreto che userai davvero: ricevere dati da un form esterno e salvarli automaticamente su Google Sheets, con validazione e gestione degli errori inclusa. Alla fine avrai anche gli strumenti per capire quando n8n è la scelta giusta e quando invece conviene un'altra strada.

Perché n8n e non Zapier o Make

Zapier e Make (ex Integromat) sono più semplici da avviare, ma hanno due limiti che in azienda si sentono presto: i costi crescono con il numero di esecuzioni (non con la complessità), e i tuoi dati passano sempre dai loro server. n8n, essendo self-hosted, elimina entrambi i problemi: paghi solo l'hosting (pochi euro al mese su una VPS), e ogni webhook, credenziale e dato transitano solo sulla tua infrastruttura. Il compromesso è che devi occupartene tu — installazione, aggiornamenti, backup. Per un progetto personale o un test rapido, Zapier resta più veloce da avviare; per un'automazione che diventerà parte dei processi aziendali, n8n si ripaga in pochi mesi.

Step 1: Installazione con Docker

Il modo più veloce per iniziare è con Docker. Un comando e n8n è pronto:

docker run -it --rm \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

Apri http://localhost:5678 nel browser. Crea il tuo account. Done. Se preferisci non gestire nulla in autonomia, esiste anche n8n.cloud (versione gestita a pagamento) — utile per validare un'idea prima di investire in un'installazione self-hosted.

Step 2: Il tuo primo workflow

Ogni workflow n8n è una sequenza di nodi collegati da frecce: un trigger (cosa fa partire il workflow — un webhook, un timer, una nuova riga in un foglio) seguito da una o più azioni (cosa succede dopo — salva un dato, invia un'email, chiama un'API). Non serve altro per iniziare a ragionare in n8n: se sai descrivere il processo a parole ("quando arriva X, fai Y, poi Z"), sai già costruirlo.

Creiamo qualcosa di pratico subito: ricevi un webhook → salva i dati su Google Sheets. Classico caso d'uso: raccogliere lead da un form esterno.

1. Nodo Webhook

• Clicca "+" e cerca "Webhook"
• Imposta Method: POST
• Copia l'URL generato (lo usi per testare)

2. Nodo Google Sheets

• Connetti il nodo Webhook a Google Sheets con una freccia
• Autentica il tuo account Google (OAuth 2.0)
• Seleziona il foglio di destinazione
• Mappa i campi: body.nome → Colonna A, body.email → Colonna B

3. Attiva e testa

curl -X POST http://localhost:5678/webhook/il-tuo-id \
  -H "Content-Type: application/json" \
  -d '{"nome": "Mario Rossi", "email": "mario@esempio.it"}'

Verifica che i dati appaiano nel foglio Google. Se sì: hai il tuo primo workflow funzionante.

Aggiungere logica: valida prima di salvare

Un workflow reale raramente si ferma al primo salvataggio. Aggiungiamo un controllo: salviamo solo i lead con un'email valida, e scartiamo (o segnaliamo) il resto.

1. Nodo IF, tra Webhook e Google Sheets

• Inserisci un nodo IF subito dopo il Webhook
• Condizione: {{$json.body.email}} contiene @
• Ramo "true" → collega a Google Sheets (come prima)
• Ramo "false" → collega a un nodo Slack o Email per segnalare il dato scartato

Con questo pattern — trigger → validazione → azione differenziata — copri l'80% dei workflow aziendali reali: qualificazione lead, smistamento ticket, controllo dati prima di un import. Per logiche più complesse (es. arricchire il lead con dati esterni prima di deciderne il destino) si aggiunge un nodo HTTP Request che chiama un'API esterna prima del nodo IF.

Step 3: Deploy in produzione

Per un ambiente stabile, usa Docker Compose con restart automatico:

# docker-compose.yml
version: '3.8'
services:
  n8n:
    image: n8nio/n8n
    ports:
      - "5678:5678"
    volumes:
      - ~/.n8n:/home/node/.n8n
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=password_sicura
    restart: unless-stopped

Best practices per la produzione

• Variabili d'ambiente per API key e credenziali — mai hardcoded nel workflow, altrimenti finiscono nel JSON esportato e in ogni backup
• Error handling con nodi IF e Error Trigger — ogni workflow deve gestire i fallimenti e notificarti, non fallire in silenzio
• Logging su Google Sheets o database — tieni traccia di ogni esecuzione: quando serve fare debug su un caso specifico, senza log sei alla cieca
• Testa prima di attivare — sempre in modalità test con dati reali ma non critici, mai direttamente in produzione
• Backup dei workflow — esporta i JSON e versiona su Git, così ogni modifica è tracciabile e reversibile
• Rate limiting sui webhook pubblici — un webhook esposto senza limiti è un invito ad abusi; usa un reverse proxy (nginx, Cloudflare) davanti a n8n

Errori comuni quando inizi con n8n

Workflow troppo grandi, tutti in uno. Se un singolo workflow gestisce 10 casi diversi, ogni modifica diventa rischiosa. Meglio più workflow piccoli e specifici, collegati tramite il nodo "Execute Workflow".

Nessun controllo sui dati in ingresso. Un webhook riceve quello che gli mandano — anche dati malformati o vuoti. Senza un nodo IF o Set che normalizza l'input, un solo campo mancante può far fallire l'intero workflow.

Credenziali duplicate tra ambienti. Usare le stesse credenziali API su test e produzione è il modo più comune per scoprire un bug quando è già troppo tardi. Separa sempre gli ambienti.

Ignorare i limiti di rate delle API esterne. Google Sheets, Slack e la maggior parte delle API hanno limiti di chiamate al minuto. Un workflow che processa un batch di 1000 righe senza pause può venire bloccato a metà.

Domande frequenti

n8n è davvero gratuito?

La versione self-hosted è open-source e gratuita (licenza fair-code): la usi liberamente, paghi solo l'hosting. n8n.cloud, la versione gestita, ha un piano gratuito limitato e piani a pagamento in base al numero di esecuzioni.

Serve sapere programmare per usare n8n?

Per workflow semplici no — è visuale, a nodi. Per logiche più avanzate (trasformazioni dati complesse, chiamate API personalizzate) aiuta conoscere le basi di JavaScript, che puoi usare nel nodo "Code" quando serve.

n8n può sostituire un vero backend?

Per orchestrare processi e integrare servizi esterni, spesso sì. Per logica applicativa complessa, dati ad alto volume o requisiti di performance stringenti, resta uno strumento di automazione — non un sostituto di un'architettura backend dedicata.