Come costruire un generatore di preventivi con Claude collegato a Zoho CRM

Un generatore di preventivi con Claude è un flusso di lavoro in cui il modello linguistico di Anthropic redige la bozza di un'offerta commerciale partendo dai dati di prodotto e dalle regole di prezzo dell'azienda. Prima che l'offerta arrivi al cliente, una persona la controlla e la approva. In una configurazione ben fatta i dati arrivano da Zoho CRM, dove anagrafiche, articoli e prezzi sono già gestiti.

Scrivere un testo commerciale non è la parte difficile. La difficoltà sta nel far sì che ogni cifra dell'offerta corrisponda al listino in vigore, che gli sconti restino entro le soglie decise dalla direzione e che le condizioni siano sempre quelle approvate. Un modello che non riceve il listino tende a completare il documento comunque, e una bozza scritta bene con un prezzo sbagliato è più pericolosa di nessuna bozza.

Per questo il generatore descritto in questa guida ha quattro parti distinte: le regole di prezzo e i modelli di documento, un collegamento che legge i dati dal gestionale, una Skill che compone l'offerta e un'approvazione umana. Decisione sul prezzo, margine e responsabilità verso il cliente restano all'azienda. Le sezioni che seguono spiegano ogni parte, poi mostrano un esempio completo, una lista di controlli e le implicazioni per un'impresa italiana.

In italiano la parola "preventivo" copre due documenti che conviene tenere separati, perché il generatore deve sapere quale sta producendo. La stima (in inglese estimate) è, secondo la pagina del generatore di Billdu, un documento consegnato prima dell'acquisto che approssima il costo di beni o servizi: non è definitivo e può cambiare se cambiano perimetro o condizioni. L'offerta a prezzo fisso (quote) è invece un prezzo su cui il cliente può contare per un periodo stabilito.

La stessa fonte suggerisce di usare la stima quando il perimetro è incerto e l'offerta a prezzo fisso quando si può impegnarsi sul numero. La fattura è il documento fiscale che documenta l'operazione ai fini IVA: in Italia va emessa anche quando il cliente paga un acconto prima del lavoro, limitatamente all'importo incassato. Il generatore di preventivi si ferma prima della fattura.

Qualunque sia il tipo, un documento completo contiene alcuni elementi ricorrenti:

• ragione sociale, indirizzo e contatti dell'azienda, con il numero fiscale o di registrazione dove richiesto, più i dati del cliente;
• un numero di documento univoco, che permette a entrambe le parti di catalogare e ritrovare l'offerta;
• la durata di validità e i termini e le condizioni;
• i metodi di pagamento accettati, l'eventuale acconto e il modo in cui il cliente può approvare.

Questi elementi diventano il modello che la Skill compila e la lista che il revisore verifica.

Prima di scrivere una riga di istruzioni conviene definire i componenti e i termini, perché ciascuno ha un ruolo preciso e un limite preciso.

Regole di prezzo e modelli

Sono i documenti di riferimento: la politica di sconto, le soglie oltre le quali serve un'autorizzazione, le condizioni standard e il modello grafico dell'offerta. Vanno scritti una volta sola, in forma chiara e tabellare, e custoditi in un unico progetto documentale.

Il connector verso il gestionale

Il Model Context Protocol, o MCP, è uno standard open source per collegare le applicazioni di intelligenza artificiale a sistemi esterni. La documentazione lo paragona a una porta USB-C: un modo standardizzato di collegare applicazioni AI a fonti di dati, strumenti e flussi di lavoro. Un server MCP è il componente che espone dati e strumenti, per esempio la lettura di articoli e prezzi dal CRM.

La Skill

Le Agent Skills estendono le capacità di Claude tramite cartelle organizzate di istruzioni, script e risorse. In termini pratici, come spiega un articolo divulgativo sulle Skill, è un file in cui si mette per iscritto come si lavora, salvato una volta sola, che Claude carica automaticamente o che si richiama quando serve. Lo stesso autore osserva che le Skill non rendono Claude più intelligente, ma rendono il lavoro più strutturato.

L'approvazione

Una persona con l'autorità di impegnare l'azienda legge la bozza e decide se inviarla. Questa parte non si automatizza.

Il primo errore di progettazione è copiare il listino dentro le istruzioni o in un documento caricato una tantum. La guida di Anthropic sull'agente di assistenza clienti lo dice per un caso analogo: per informazioni in tempo reale, come saldi dei conti o dettagli delle polizze, gli approcci di recupero basati su embedding non sono sufficienti, e l'uso degli strumenti migliora la capacità del sistema. Un listino che cambia durante l'anno rientra nella stessa categoria.

C'è poi un vincolo tecnico che determina l'architettura. Secondo la documentazione delle Skill, le Skill girano nel contenitore di esecuzione del codice senza accesso alla rete e senza installazione di pacchetti a runtime. Una Skill, quindi, non può interrogare da sola Zoho CRM: i dati di prodotto devono arrivarle già letti dal connector, e la Skill si limita ad applicare regole e modello.

Nei progetti di Svennis teniamo il listino fuori dal testo della Skill e lo facciamo leggere dal CRM nel momento in cui si prepara la bozza: quando i prezzi vivono dentro le istruzioni, prima o poi qualcuno aggiorna il gestionale e nessuno aggiorna la Skill. Se il listino ufficiale è mantenuto in Zoho Books anziché nel CRM, il connector legge da lì; conta che la fonte sia una sola e che sia quella usata anche per fatturare.

Una Skill personalizzata è una cartella che contiene al livello principale un file SKILL.md con un'intestazione YAML, più gli script e le risorse di supporto. L'intestazione ha due campi obbligatori: name, al massimo 64 caratteri con sole lettere minuscole, numeri e trattini, e description, al massimo 1024 caratteri, non vuota e senza tag XML. La descrizione deve dire in modo esplicito quando la Skill va usata.

Nella cartella conviene mettere:

• il modello dell'offerta con tutti i campi della sezione precedente;
• le regole di sconto in forma di tabella, con le soglie che richiedono autorizzazione;
• uno script che calcola righe, sconti e totali, così che l'aritmetica non dipenda dalla formulazione del testo;
• alcune offerte già approvate come esempi. Per l'assistenza clienti Anthropic consiglia almeno 4-5 esempi di interazioni "buone": lo stesso principio vale per le offerte.

Le Skill si integrano con la Messages API tramite lo strumento di esecuzione del codice, necessario sia per le Skill predefinite sia per quelle personalizzate. Anthropic mette a disposizione Skill predefinite chiamate docx, pdf, xlsx e pptx: per un'offerta in Word o PDF non serve costruire da zero la generazione del file. Quando una Skill crea un documento, la risposta restituisce un attributo file_id e il file si scarica con la Files API.

I limiti da conoscere: al massimo 20 Skill per richiesta e 30 MB per Skill, contando tutti i file non compressi. Le Skill personalizzate sono private al workspace e si caricano e gestiscono tramite la Skills API, che è uscita dalla fase beta.

Ipotizziamo una piccola impresa di distribuzione con tre commerciali, che gestisce clienti, articoli e prezzi in Zoho CRM. L'obiettivo è che ogni commerciale ottenga una bozza di offerta a prezzo fisso in formato Word, pronta per la revisione del responsabile commerciale.

Impostazioni

• Nome della Skill: offerta-da-listino.
• Descrizione: "Redige offerte commerciali a prezzo fisso usando i dati di cliente e articoli ricevuti dal CRM, applica il file regole-sconto e produce un documento Word da sottoporre ad approvazione."
• Risorse: modello-offerta.docx, regole-sconto in tabella, lo script di calcolo, cinque offerte approvate come esempi.
• Skill predefinita usata per il file: docx.
• Versione della Skill: fissata, mai latest (il motivo è spiegato più avanti).

Il flusso

1. Il commerciale chiede la bozza indicando cliente e articoli.
2. Il connector MCP legge dal CRM anagrafica, condizioni del cliente e prezzi correnti.
3. La Skill applica le regole di sconto, esegue lo script di calcolo e compila il modello.
4. Il documento torna con un file_id e viene scaricato tramite la Files API.
5. Il responsabile commerciale verifica e approva; solo allora l'offerta parte.

I costi da mettere a budget

Secondo la pagina prezzi di Claude, un posto standard del piano Team costa 20 dollari al mese con fatturazione annuale o 25 con fatturazione mensile: per tre persone sono 60 o 75 dollari al mese. Se il flusso passa dall'API, Sonnet 5 costa 2 dollari per milione di token in ingresso e 10 in uscita, Haiku 4.5 costa 1 e 5. L'esecuzione del codice include 50 ore gratuite al giorno per organizzazione, poi 0,05 dollari per ora per contenitore.

L'approvazione umana funziona solo se il revisore sa che cosa guardare. Una lista fissa riduce il tempo di revisione e rende confrontabili le decisioni di persone diverse. Tra i guardrail che Anthropic raccomanda per gli agenti rivolti ai clienti figura la riduzione delle allucinazioni: nel caso delle offerte significa confrontare ogni cifra con la fonte, non con la memoria del revisore.

Se un controllo fallisce spesso, la correzione va fatta nella Skill o nelle regole, non offerta per offerta. Tenere traccia dei motivi di rifiuto per qualche settimana indica con precisione quale istruzione riscrivere.

Una Skill che scrive offerte è a tutti gli effetti una regola commerciale, e va gestita con la stessa disciplina. La documentazione di Anthropic segnala un rischio concreto: se la versione viene omessa o impostata su latest, una versione caricata da chiunque nel workspace cambia immediatamente ciò che gli agenti in produzione eseguono. Per questo nell'esempio la versione è fissata e ogni aggiornamento passa da un test.

Altri tre dettagli contano per chi deve rispondere dei preventivi emessi:

• ogni versione di una Skill personalizzata è una fotografia completa, non una modifica incrementale: i file omessi nel nuovo caricamento non vengono riportati;
• eliminare una Skill ne cancella anche tutte le versioni;
• con la Compliance API attiva, il suo Activity Feed registra creazione ed eliminazione di Skill e versioni, mentre le operazioni avvenute con la Compliance API spenta non vengono registrate né recuperate.

Sul piano tecnico, se si usa il prompt caching, cambiare l'elenco delle Skill nel contenitore invalida la cache: conviene quindi definire un insieme stabile di Skill per il flusso delle offerte. Infine, le Agent Skills non rientrano negli accordi di Zero Data Retention: definizioni ed esecuzioni sono conservate secondo la politica standard di Anthropic. Questo punto va valutato prima di far passare dati di clienti attraverso la Skill.

Un generatore costruito su Claude e sul CRM non è l'unica strada, e per alcune aziende non è la più sensata. Esistono strumenti pronti che risolvono bene parti del problema.

La scelta dipende da dove vivono i dati. Se prezzi e clienti sono già nel CRM e le offerte richiedono giudizio commerciale, uno strumento esterno obbliga a ricopiare dati e crea una seconda fonte di verità. Se invece i preventivi sono standard e poco frequenti, uno strumento pronto costa meno tempo di progettazione.

Tre aspetti pratici riguardano in modo specifico un'azienda che opera in Italia. Il primo è economico: la pagina prezzi di Claude esprime i piani in dollari, quindi il costo in euro varia con il cambio e va rivisto a ogni rinnovo. Il diritto di recesso di 14 giorni previsto dal Codice del Consumo tutela i consumatori e non le imprese: prima di acquistare posti per il Suo team, verifichi nelle condizioni di Anthropic se e a quali condizioni è previsto un rimborso per gli acquisti aziendali.

Il secondo riguarda i dati. Le offerte contengono dati di clienti, condizioni negoziate e margini impliciti. Poiché le Agent Skills sono conservate secondo la politica standard di Anthropic e non rientrano nella Zero Data Retention, è opportuno che il responsabile della protezione dei dati o il consulente privacy valuti il flusso prima dell'avvio, e che la Skill riceva solo i campi necessari all'offerta.

Il terzo è documentale. Se l'offerta è emessa da una società italiana, il modello deve riportare i dati richiesti dall'articolo 2250 del codice civile: sede, ufficio del registro delle imprese e numero di iscrizione, per S.p.A., S.a.p.A. e S.r.l. il capitale sociale effettivamente versato ed esistente dall'ultimo bilancio, per S.p.A. e S.r.l. l'eventuale socio unico e, se del caso, lo stato di liquidazione; è buona prassi indicare anche la partita IVA, prevista dalla normativa IVA. Le condizioni devono essere quelle che l'azienda usa già nei contratti. Per chi vende all'estero è utile sapere che, secondo la guida di Anthropic, Claude sostiene conversazioni in oltre 200 lingue: la bozza può essere preparata nella lingua del cliente, ma la revisione va fatta da chi quella lingua la conosce. La documentazione tecnica di riferimento, inclusa la guida sull'assistenza clienti citata sopra, è disponibile anche in italiano.

Il modo più sicuro di partire è un pilota ristretto, con un solo tipo di offerta e un solo approvatore. Questa sequenza permette di capire in poche settimane se il flusso regge.

1. Scegliere la fonte unica del listino: CRM o gestionale contabile, ma una sola, e verificare che articoli e prezzi siano aggiornati.
2. Scrivere le regole di sconto in una tabella, con le soglie e il nome di chi autorizza oltre soglia.
3. Raccogliere cinque offerte già approvate da usare come esempi nella Skill.
4. Definire il modello con tutti i campi: tipo di documento, validità, condizioni, pagamento, acconto, numero univoco e, per una società italiana, i dati richiesti dall'articolo 2250 del codice civile (sede, ufficio e numero di iscrizione al registro delle imprese, capitale sociale versato ed esistente per S.p.A., S.a.p.A. e S.r.l., eventuale socio unico per S.p.A. e S.r.l., eventuale stato di liquidazione) e la partita IVA.
5. Fissare la versione della Skill e attivare la Compliance API prima di caricarla.
6. Misurare per qualche settimana i motivi per cui il revisore corregge o rifiuta le bozze, e intervenire sulle regole.

Se il Suo team usa già Claude nel lavoro quotidiano, la guida pratica a Claude Cowork in azienda spiega come partire dai processi che già funzionano, ed è il punto di ingresso più naturale per questo progetto. Se invece l'offerta approvata deve proseguire fino all'ordine e alla fattura senza ricopiare dati, il post sull'automazione degli ordini B2B con un unico sistema Zoho descrive il tratto successivo del processo.