Vai al contenuto
Claude AILa Guida Operativa Completa

L'ufficio che si organizza da solo

Il progetto P5: il flusso n8n pronto da importare e il collaudo su dieci email vere.

Scarica tutto (.zip) Capitolo 6.5 del libro

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)

  1. Apri il tuo n8n (la Community Edition self-hosted gratuita va benissimo; nel libro la facciamo girare con Docker).
  2. 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-attivita e la variabile d'ambiente N8N_RESTRICT_FILE_ACCESS_TO=/home/node/p5-attivita. Bonus di igiene: così il flusso può scrivere SOLO lì.
  3. Menu del pannello workflow → Import from File… → scegli flusso-p5-n8n.json.
  4. Attiva il workflow (interruttore in alto a destra).
  5. 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

  1. L'AI produce, l'umano approva. I due nodi di approvazione non si eliminano: un preventivo sbagliato costa più di dieci minuti risparmiati.
  2. 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.
  3. 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

FileA cosa servePeso
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