Tutorial su n8n (2026): crea il tuo primo workflow passo passo
komasu Tools è sostenuto da lettori come te. Se acquisti tramite i nostri link potremmo ricevere una commissione di affiliazione, che ci permette di offrire gratuitamente la nostra ricerca. Come guadagniamo
Un workflow n8n Cloud pubblicato che gira in base a una pianificazione, recupera dati da un'API, conserva solo gli elementi che ti interessano e li pubblica in un canale Slack.
Prova n8n gratisCosa creerai
In questo tutorial costruisci su n8n Cloud un'automazione piccola ma realistica. Ogni mattina recupera da un'API un elenco di record, conserva solo quelli che soddisfano una condizione e pubblica ogni corrispondenza in un canale Slack. Pensa a nuovi ordini sopra un certo valore, ticket di supporto aperti o attività in scadenza oggi.
Il workflow usa quattro nodi, tutti tratti dalla documentazione ufficiale di n8n:
- Schedule Trigger avvia il workflow a un orario stabilito.
- HTTP Request chiama l'API e restituisce i suoi dati.
- Filter conserva solo gli item che soddisfano la tua condizione.
- Slack invia un messaggio per ogni item rimasto.
Strada facendo imparerai i concetti di base di n8n: un workflow è l'intera automazione, un nodo è un singolo passaggio e i dati si spostano tra i nodi come un elenco di item. Un'esecuzione è un run dell'intero workflow, ed è anche il modo in cui n8n Cloud conta l'utilizzo.
Prima di iniziare
Servono tre cose:
- Un account n8n Cloud. Secondo n8n, la prova di 14 giorni non richiede carta di credito e include le funzioni Pro con 1.000 esecuzioni. È molto più di quanto consuma questo tutorial. Avvia una prova gratuita di n8n Cloud.
- Un'API che restituisce JSON. Può essere il tuo negozio, il tuo help desk o il tuo strumento di gestione dei progetti, oppure una qualsiasi API pubblica. Ti servono il suo URL e, se richiesta, una chiave API. Guarda una volta la risposta nel browser o nella documentazione dell'API così conosci i nomi dei campi.
- Un workspace Slack in cui ti è consentito aggiungere app e un canale per i messaggi di prova.
Se preferisci l'email, puoi sostituire Slack con il nodo Gmail nel Passo 5. Il resto non cambia.
Se stai ancora decidendo se n8n sia lo strumento giusto, leggi prima la nostra recensione di n8n.
Passo 1: crea un nuovo workflow
Accedi a n8n Cloud. Nel menu a sinistra seleziona Personal, poi Create workflow. Ora vedi un canvas vuoto, l'area in cui posizioni e colleghi i nodi.
Dai al workflow un nome chiaro, come "Daily filtered report to Slack". I nomi contano quando hai decine di workflow e compaiono negli avvisi di errore.
n8n offre anche un Assistant integrato che può costruire un workflow da un prompt in chat. È utile più avanti, ma costruire a mano la prima volta ti insegna come si incastrano i pezzi.
Passo 2: aggiungi uno Schedule Trigger
Ogni workflow inizia con un nodo trigger. Seleziona Add first step, poi scegli On a schedule. Questo aggiunge il nodo Schedule Trigger.
Nelle impostazioni del nodo, mantieni l'intervallo in giorni e imposta Trigger at Hour all'orario che vuoi, per esempio le 8 del mattino. La pianificazione usa il fuso orario della tua istanza n8n, quindi controlla che corrisponda a dove ti trovi.
Rinomina il nodo con qualcosa di descrittivo, come "Every day at 8 AM". Chiudi il pannello per tornare al canvas.
Passo 3: recupera i dati con il nodo HTTP Request
Seleziona il pulsante + sul lato destro del nodo trigger. In Search nodes digita "http" e scegli HTTP Request.
Imposta il metodo su GET e incolla l'indirizzo della tua API nel campo URL. Se l'API richiede l'autenticazione, selezionala nelle impostazioni di autenticazione e conserva la chiave come credenziale. Le credenziali sono salvate separatamente dal workflow, quindi la chiave non compare nel nodo stesso e può essere riutilizzata.
Ora seleziona Execute step. n8n chiama l'API una volta e mostra il risultato nel pannello di output. Se la risposta è un elenco, dovresti vedere più item. Se il tuo elenco è annidato dentro un campo di un singolo oggetto (per esempio data o results), aggiungi dopo questo un nodo Split Out e puntalo a quel campo in modo che ogni record diventi un item a sé.
Rinomina il nodo con qualcosa come "Get records". Eseguire un passaggio e guardarne l'output reale prima di andare avanti è l'abitudine più utile in n8n.
Passo 4: conserva solo ciò che conta con il nodo Filter
Aggiungi un nodo dopo HTTP Request e cerca Filter. Secondo la documentazione di n8n, il nodo Filter lascia passare gli item che soddisfano una condizione e scarta gli altri.
Imposta la condizione:
- Nel primo campo del valore, fai riferimento a un campo dell'input. Apri il pannello di input a sinistra e trascina il campo (per esempio
statusoamount) nella casella del valore. n8n scrive un'espressione come{{ $json.status }}, che sostituisce con il valore reale di ogni item al momento dell'esecuzione. - Usa il menu a tendina del tipo di dato per scegliere il tipo e il confronto, come String con "is equal to" o Number con "is greater than".
- Digita il valore con cui confrontare, come
openo100.
Per aggiungere altre regole, seleziona Add condition e scegli AND (tutte le condizioni devono corrispondere) oppure OR (può corrispondere una qualsiasi condizione). Non puoi mescolare AND e OR dentro un singolo nodo Filter. Tra le opzioni, Ignore Case rende i confronti di testo insensibili alle maiuscole e Less Strict Type Validation aiuta se vedi un errore di "wrong type".
Seleziona di nuovo Execute step. L'output dovrebbe ora contenere solo gli item corrispondenti. Se è vuoto, controlla la tua condizione rispetto ai dati di input prima di andare avanti.
Passo 5: pubblica ogni corrispondenza su Slack
Aggiungi un nodo dopo Filter e cerca Slack. Come azione scegli la risorsa Message con l'operazione Send, che pubblica un messaggio in un canale.
Poi collega il tuo account Slack. Il nodo Slack supporta l'autenticazione OAuth2 e con Access Token. Crea una nuova credenziale dal nodo e segui i passaggi della pagina di n8n sulle credenziali Slack. Se configuri una tua app Slack, assicurati che abbia gli scope che la documentazione elenca per l'invio di messaggi.
Poi scegli il canale e scrivi il testo del messaggio. Mescola testo fisso con espressioni dall'input, per esempio:
New item: {{ $json.name }} (status: {{ $json.status }})
Usa i nomi dei campi dei tuoi dati. n8n esegue il nodo Slack una volta per ogni item in ingresso, quindi tre item filtrati producono tre messaggi.
Seleziona Execute step e controlla il canale Slack. Quando i messaggi di prova sembrano a posto, rinomina il nodo in "Post to Slack".
Passo 6: testa l'intero workflow e pubblicalo
Finora hai testato un nodo alla volta. Ora seleziona Execute sotto il canvas per eseguire l'intero workflow dal trigger. Ogni nodo dovrebbe mostrare un segno di spunta verde quando ha successo.
Un workflow testato non gira ancora da solo. Per attivare la pianificazione, seleziona Publish nell'intestazione del canvas. D'ora in poi n8n avvia il workflow automaticamente all'orario impostato nel Passo 2 e ogni run conta come una esecuzione.
Se modifichi il workflow in seguito, ricordati di pubblicarlo di nuovo perché la versione attiva recepisca le tue modifiche.
Passo 7: controlla i run e aggiungi un avviso di errore
Apri la scheda delle esecuzioni del workflow per vedere i run passati, se ciascuno è riuscito e i dati che sono passati da ogni nodo. È qui che guardi per prima cosa quando qualcosa va storto.
Come rete di sicurezza, crea un secondo workflow che inizia con il nodo Error Trigger e invia un messaggio Slack o un'email con i dettagli dell'errore. Poi apri il tuo workflow principale, vai su Options > Settings e scegli quel workflow sotto Error workflow. Secondo la documentazione di n8n, il workflow di errore riceve l'ID dell'esecuzione fallita, il messaggio di errore e l'ultimo nodo eseguito, e un solo workflow di errore può servire molti workflow.
Passo 8 (facoltativo): gestisci n8n da solo con Docker
n8n Cloud è il modo più semplice per iniziare, ma puoi anche installare in self-hosting la Community Edition gratuita. La sua licenza è la Sustainable Use License, che consente l'uso aziendale interno, personale e non commerciale. La documentazione di n8n avverte che il self-hosting richiede competenze tecniche e che gli errori possono causare perdita di dati, problemi di sicurezza e downtime.
Per un test locale, la documentazione descrive questa configurazione con Docker Desktop installato:
- Crea un volume in modo che i tuoi dati sopravvivano ai riavvii:
docker volume create n8n_data - Avvia n8n con l'immagine ufficiale, mappando la porta 5678 e montando il volume:
docker run -it --rm --name n8n -p 5678:5678 -e GENERIC_TIMEZONE="<YOUR_TIMEZONE>" -e TZ="<YOUR_TIMEZONE>" -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true -v n8n_data:/home/node/.n8n n8nio/n8n - Apri
http://localhost:5678nel browser.
Sostituisci <YOUR_TIMEZONE> con il nome di un fuso orario come America/New_York. Per qualsiasi cosa oltre a un test locale, la documentazione di n8n consiglia invece l'installazione con Docker Compose, e sei tu il responsabile di aggiornamenti, backup e HTTPS. Alcune funzioni per i team, come i progetti e l'SSO, non fanno parte della Community Edition.
Errori comuni
- Testare ma non pubblicare mai. Execute esegue il workflow solo una volta. Finché non selezioni Publish, lo Schedule Trigger non partirà.
- Ignorare gli item. n8n elabora ogni item che raggiunge un nodo. Se l'API restituisce 50 record e il tuo filtro è sbagliato, Slack riceve 50 messaggi.
- Fare riferimento a campi che non esistono. Un'espressione come
{{ $json.amount }}non restituisce nulla se il campo si chiamatotal. Trascina sempre i campi dal pannello di input invece di digitarli. - Elenchi annidati. Se tutti i record arrivano come un solo item, l'elenco è annidato dentro un campo. Aggiungi un nodo Split Out prima del Filter.
- Fuso orario sbagliato. Una pianificazione che parte all'ora "sbagliata" di solito significa che il fuso orario dell'istanza è diverso dal tuo.
- Scrivere le chiavi API nel codice. Conserva le chiavi come credenziali, non dentro URL o testo dei messaggi.
Prossimi passi
Ora hai un workflow pubblicato che gira ogni mattina e segnala solo ciò che conta. Da qui, prova ad aggiungere un nodo If per inviare messaggi diversi per casi diversi, oppure sostituisci Slack con Gmail per un riepilogo via email. Anche la libreria di template di n8n è un buon posto per vedere come altri strutturano flussi simili.
Se vuoi confrontare n8n con altri strumenti prima di costruire altro, leggi Make vs n8n e Zapier vs n8n, oppure segui il nostro tutorial su Make per costruire lì lo stesso tipo di workflow.
Domande frequenti
Devo saper programmare per seguire questo tutorial?
No. Ogni passaggio usa i nodi visuali e i campi dei moduli di n8n. Scriverai qualche breve espressione, ma nessun codice.
La prova di n8n Cloud costa qualcosa?
Secondo n8n, la prova Cloud di 14 giorni non richiede carta di credito e include le funzioni Pro con 1.000 esecuzioni. Se non passi a un piano a pagamento, la prova termina automaticamente.
Quante esecuzioni consuma questo workflow?
Una per ogni run. n8n conta come esecuzione un singolo run dell'intero workflow, a prescindere da quanti nodi abbia, quindi una pianificazione giornaliera consuma circa 30 esecuzioni al mese.
Qual è la differenza tra Execute e Publish?
Execute esegue il workflow una volta così puoi testarlo. Publish lo rende attivo, così lo Schedule Trigger lo avvia automaticamente negli orari che hai impostato.
Posso inviare un'email invece di un messaggio Slack?
Sì. Sostituisci il nodo Slack con il nodo Gmail o un altro nodo email e mappa gli stessi campi nel messaggio.
Posso far girare questo workflow sul mio server?
Sì. Puoi installare in self-hosting la Community Edition di n8n con Docker, come descritto nell'ultimo passo, e importare o ricostruire lì il workflow.
Vedi la cronologia degli aggiornamenti di questo articolo
- Prima pubblicazione.