# 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:

```bash
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.