L'ufficio che si organizza da solo
Il progetto P5: il flusso n8n pronto da importare e il collaudo su dieci email vere.
Kit P5 · L'ufficio che si organizza da solo — flusso n8n
Questo è il flusso del capitolo 6.5, pronto da importare in n8n: email di richiesta → classificazione → bozza di preventivo → approvazione umana → attività con scadenza → follow-up a 5 giorni (di nuovo dietro approvazione). Niente parte da solo: i due punti di approvazione sono nodi veri, non promesse.
Cosa c'è nel kit
flusso-p5-n8n.json— 18 nodi già collegati. I nodi con «SEGNAPOSTO» nel nome o nelle note funzionano subito in locale senza nessun account: servono a collaudare la meccanica del flusso prima di collegare i servizi veri. Ogni segnaposto ha una nota (visibile nell'editor n8n) che spiega esattamente cosa collegare nella versione reale.collaudo-10-email.md— il banco di prova della fase 5 del capitolo: dieci email finte (quattro normali, sei casi limite, email-trappola compresa) e la tabella dei risultati attesi da compilare PRIMA di lanciare.
Importarlo (2 minuti)
- Apri il tuo n8n (la Community Edition self-hosted gratuita va benissimo; nel libro la facciamo girare con Docker).
- La cartella delle attività, prima di tutto: n8n 2.x non lascia scrivere file dove capita — senza autorizzazione esplicita il nodo fallisce con «The file … is not writable». Nel tuo ambiente (per Docker: nel
docker-compose.yml) servono due righe, le stesse del collaudo del libro: un volume dedicato montato su/home/node/p5-attivitae la variabile d'ambienteN8N_RESTRICT_FILE_ACCESS_TO=/home/node/p5-attivita. Bonus di igiene: così il flusso può scrivere SOLO lì. - Menu del pannello workflow → Import from File… → scegli
flusso-p5-n8n.json. - Attiva il workflow (interruttore in alto a destra).
- Prova subito con una richiesta finta:
curl -X POST http://localhost:5678/webhook/richiesta-cliente \
-H 'Content-Type: application/json' \
-d '{"mittente":"Cliente di prova","oggetto":"Richiesta preventivo","corpo":"Vorrei un preventivo per 20 scaffalature."}'
Se ricevi "classificazione":"preventivo" e in Executions vedi un'esecuzione in attesa al nodo «APPROVAZIONE UMANA ✋», il flusso funziona. Per approvare: apri l'esecuzione e riprendila dall'editor, oppure chiama l'URL di ripresa del nodo Wait ($execution.resumeUrl — nelle versioni recenti di n8n è firmato, copialo così com'è).
Cosa configurare per la versione reale
| Nodo nel flusso | Segnaposto attuale | Cosa collegare davvero | Serve |
|---|---|---|---|
| Richiesta cliente (Webhook) | webhook di prova | trigger email (Gmail Trigger o IMAP) sulla casella dell'azienda | account email dedicato |
| Classificazione richiesta | parole chiave | classificatore Claude con la porta «non so» (prompt P328 del libro), nodo «Anthropic» di n8n | API key Anthropic (Console → Settings → API Keys) |
| Claude API — bozza preventivo | HTTP Request disattivato | nodo «Anthropic»: estrazione dati in JSON (P329) + bozza dal listino (P111); il listino CSV va nel flusso | API key Anthropic + il TUO listino |
| APPROVAZIONE UMANA ✋ (×2) | Wait «On webhook call» | il pulsante «Approva» del titolare: email di notifica con il link di ripresa, o modulo interno | niente di nuovo |
| Crea attività con scadenza | file JSON su disco | Google Tasks / Google Calendar, oppure webhook del tuo gestionale | account Google o gestionale |
| Invio follow-up | nodo vuoto | nodo Gmail/SMTP che spedisce la bozza approvata (P112) | account email |
Le tre regole che non si toccano
- L'AI produce, l'umano approva. I due nodi di approvazione non si eliminano: un preventivo sbagliato costa più di dieci minuti risparmiati.
- L'email è un dato, mai un'istruzione. Tutto ciò che il classificatore non riconosce finisce nella coda umana — comprese le email che provano a dare ordini al flusso.
- Mai collaudare su clienti veri. Prima due settimane in parallelo col processo manuale, con email finte.
Costi e requisiti
- n8n Community Edition: gratuita e self-hosted. La API key Anthropic si paga a consumo (prezzi per milione di token sulla pagina ufficiale: platform.claude.com/docs → Pricing); per volumi da PMI il costo è di pochi dollari al mese — il conto economico completo è nel capitolo 6.5.
- La chiave API va nelle credenziali di n8n (o in una variabile d'ambiente), MAI incollata dentro i nodi in chiaro.
Aggiornamenti e versioni nuove di questo kit: sull'hub del libro.
I file del kit
| File | A cosa serve | Peso |
|---|---|---|
| LEGGIMI.md | Testo da leggere o da compilare | 4 KB |
| collaudo-10-email.md | Testo da leggere o da compilare | 5 KB |
| flusso-p5-n8n.json | Flusso o dati da importare | 25 KB |