Come scrivere istruzioni e base di conoscenza per il chatbot che funzionano davvero

Perché la maggior parte dei chatbot dà risposte vaghe

Un chatbot vale solo quanto le due cose che gli dai: le sue istruzioni e la sua conoscenza. Se le imposti bene, risponde come il tuo miglior collaboratore nella sua giornata migliore. Se le sbagli, fa quello che fanno i chatbot deludenti: tergiversa, ti rigira la domanda, oppure inventa con sicurezza una risposta che non è vera.

Un bot che delude quasi sempre nasce da una di due lacune. O le istruzioni sono troppo scarne — "Sei un assistente utile per Acme" — e il bot non ha idea di come comportarsi, di cosa dovrebbe occuparsi o di cosa fare quando è in difficoltà. Oppure la base di conoscenza è vuota, e il bot non ha informazioni reali a cui attingere e ripiega su frasi generiche.

Questa guida risolve entrambe. Spiega la differenza tra le due — le istruzioni sono come si comporta il bot, la conoscenza è cosa sa — poi ti accompagna a scrivere bene ciascuna, a stabilire limiti onesti, e nel breve ciclo di test e rifinitura che trasforma un bot mediocre in uno di cui i clienti si fidano. Non serve alcuna competenza tecnica. Se sai scrivere una breve email a un nuovo collaboratore, sai fare anche questo.

Istruzioni e base di conoscenza: due lavori diversi

L'idea più utile di tutta questa guida: istruzioni e conoscenza sono due lavori separati, e confonderli è l'errore più comune di chi inizia.

Immagina di assumere qualcuno per la tua reception. Il primo giorno gli diresti due tipi di cose. Primo, come fare il lavoro: "Sii cordiale ma sintetico. Se qualcuno chiede dei prezzi, illustragli le opzioni. Se non sai qualcosa, non tirare a indovinare — prendi la sua email e digli che ci faremo sentire." Queste sono le istruzioni. Secondo, le informazioni che gli servono: i tuoi orari, i prezzi, la politica sui resi, dove si parcheggia. Questa è la conoscenza.

Quando metti le informazioni nel campo istruzioni — "Apriamo alle 9, una consulenza costa $50…" — succedono due cose. Le istruzioni diventano lunghe e confuse, quindi le indicazioni sul comportamento si annacquano e il bot le segue meno fedelmente. E le informazioni cambiano: quando cambiano gli orari devi scavare in un muro di testo sul comportamento per correggere una riga. Tienile separate. Le istruzioni restano brevi e stabili; le informazioni vivono nella base di conoscenza, dove si aggiornano in fretta.

Scrivere istruzioni che funzionano

Delle buone istruzioni rispondono a quattro domande per il tuo bot, in parole semplici. Trovi il campo con l'etichetta "Istruzioni per il tuo bot" nelle impostazioni del bot.

1. Chi è? Dagli un ruolo e di' quale attività rappresenta. "Sei l'assistente di Lumière Aesthetic Clinic, una clinica per pelle ed estetica." Una frase.
2. Che tono deve avere? Definiscilo in poche parole, più una riga di indicazioni. "Cordiale, rassicurante e sintetico. Usa frasi brevi. Sembra una persona disponibile, non una brochure."
3. Di cosa si occupa? Indica gli argomenti per cui è lì, così resta sul pezzo. "Aiuti con trattamenti, prezzi, consulenze, orari di apertura e come prenotare."
4. Cosa deve fare quando è in difficoltà? È quella che quasi tutti dimenticano, ed è la più importante. Di' al bot esattamente cosa fare quando non sa o non può aiutare. "Se non conosci la risposta, dillo con onestà e invita il visitatore a lasciare la sua email così una persona può ricontattarlo. Non tirare mai a indovinare un prezzo e non dare mai consigli medici — per qualsiasi domanda clinica, invita il visitatore a prenotare una consulenza."

Messe insieme, delle istruzioni complete si leggono come un breve briefing a un nuovo collaboratore:

Sei l'assistente di Lumière Aesthetic Clinic, una clinica per pelle ed estetica.
Sii cordiale, rassicurante e sintetico — frasi brevi, niente gergo.
Aiuti con trattamenti, prezzi, consulenze, orari di apertura e come prenotare.
Se qualcuno vuole prenotare, o chiede qualcosa di cui non sei sicuro, invitalo a lasciare nome ed email e digli che lo ricontatteremo a breve.
Non inventare mai un prezzo e non dare mai consigli medici o sui trattamenti — per qualsiasi domanda clinica, invita a prenotare una consulenza.

Tienile brevi. Hai circa 2.000 caratteri a disposizione — più o meno quattro paragrafi corti — e più corto di solito è meglio. Mezza pagina mirata batte due pagine di regole che il bot segue solo a metà. Hai davanti un riquadro vuoto? Butta giù qualche punto alla buona e passalo all'ottimizzatore integrato (il pulsante con la bacchetta accanto alle istruzioni): riordina gli appunti grezzi in istruzioni pulite che puoi poi modificare.

Cosa mettere nella base di conoscenza

La base di conoscenza è dove il bot prende le sue informazioni. La regola pratica: se un cliente potrebbe chiederlo, va qui. La maggior parte delle piccole attività copre il 90% delle domande reali con una sola pagina di informazioni ben organizzate.

Parti dalle domande a cui rispondi già dieci volte a settimana. Apri la tua email, i tuoi messaggi, le note del telefono — le domande che tornano sempre sono esattamente ciò che il bot deve sapere a memoria. Poi aggiungi l'essenziale:

• Orari di apertura, più festività ed eccezioni.
• Cosa vendi o offri, con prezzi o fasce di prezzo dove puoi indicarli.
• Sede, parcheggio, indicazioni e zone di consegna o servizio.
• Politiche: resi, rimborsi, cancellazioni, acconti, garanzie.
• Come prenotare, ordinare o mettersi in contatto.
• Le cinque-dieci domande a cui sei stanco di rispondere a mano.

Puoi scrivere tutto direttamente, oppure caricarlo. La base di conoscenza accetta testo incollato e file PDF, DOCX, XLSX, CSV, TXT e Markdown, fino a 5 MB l'uno — così un documento FAQ esistente, un listino prezzi o una brochure dei servizi possono entrare così come sono, e il bot ne legge il testo. Puoi combinare le fonti: incolla gli orari, carica il listino, incolla le politiche.

Come strutturare la conoscenza perché il bot la trovi

Come organizzi la conoscenza conta quasi quanto cosa ci metti. Un muro di testo funziona, ma uno leggermente strutturato funziona meglio — il bot trova l'informazione giusta più in fretta e fa meno confusione.

Tre abitudini fanno una vera differenza:

• Un argomento per intestazione. Raggruppa le informazioni sotto intestazioni brevi — Orari, Trattamenti, Prezzi, Consulenze, Prenotazioni. L'editor della conoscenza ha una barra che aggiunge le intestazioni al posto tuo, oppure puoi digitare due cancelletti (##) davanti a una riga. Le intestazioni danno al bot dei punti di riferimento.
• Un'informazione per riga. "Una consulenza costa $50 ed è scalabile da qualsiasi trattamento prenotato entro 30 giorni" su una riga a sé è più facile da citare con precisione per il bot rispetto alla stessa informazione sepolta in un paragrafo lungo.
• Scrivilo come lo chiede un cliente. Se i clienti chiedono "fate l'epilazione laser?", metti una riga che dice "L'epilazione laser parte da $90 a seduta." Rispecchia la domanda, e il bot risponde pulito.

Una base di conoscenza ben strutturata si presenta così:

## Orari di apertura
Lun–Ven: 9–19
Sabato: 9–14
Domenica e festivi: chiuso

## Consulenze e prezzi
Consulenza: $50, scalabile da qualsiasi trattamento prenotato entro 30 giorni.
Trattamenti anti-rughe: da $250.
Filler dermici: da $400.

Tienila aggiornata. La base di conoscenza conserva una cronologia delle versioni, così puoi modificare liberamente e tornare indietro se cambi idea. Quando cambiano prezzi, orari o politiche, aggiorna la base di conoscenza lo stesso giorno. Un bot che cita i prezzi dell'anno scorso è peggio di nessun bot.

Gestire le domande a cui non dovrebbe rispondere

Un bot affidabile conosce i suoi limiti. Due tipi di domande hanno bisogno di un piano: quelle a cui non dovrebbe rispondere e quelle a cui semplicemente non può.

Non dovrebbe rispondere. Alcune cose sono troppo delicate per lasciarle a un bot — un sintomo medico, una questione legale, una contestazione su una fattura. Indicale nelle istruzioni e di' al bot di passare la mano invece di improvvisare. "Per qualsiasi cosa riguardi una preoccupazione medica, non dare consigli — invita il paziente a chiamare la clinica al numero nella tua conoscenza." L'onestà qui protegge la tua reputazione.

Non può rispondere. Per tutto ciò che il bot semplicemente non sa, l'esito peggiore è una risposta sbagliata data con sicurezza. La soluzione è una riga nelle istruzioni: "Se non sai, dillo chiaramente e offriti di passare la domanda a una persona." Poi dai al visitatore una via d'uscita reale — è a questo che serve l'opzione "Parla con un umano". È attiva di default: il visitatore apre il menu della chat, ci clicca e lascia nome ed email, e il messaggio arriva nella tua casella.

Detto questo, non sovraccaricare il bot facendogli rincorrere i contatti. Il suo lavoro principale è rispondere alle domande; il passaggio a una persona è la via di fuga per quando non ci riesce. Lascia la porta aperta, ma lascia che il bot faccia prima il suo vero lavoro.

Testalo, leggi le conversazioni, rifinisci

Nessuno scrive istruzioni perfette al primo tentativo, ed è normale. Il bot diventa bravo grazie a un breve ciclo, non a una sola seduta.

Testa prima di pubblicare. Ogni bot ha un tester in sandbox dove puoi chattarci in privato, prima che arrivi vicino a un cliente (i messaggi in sandbox costano circa la metà dei crediti normali, quindi una sessione di test approfondita costa poco). Fagli le domande scomode: i casi limite, le cose che non dovrebbe toccare, la stessa domanda formulata in tre modi diversi. Scoprirai le lacune in pochi minuti.

Leggi le conversazioni reali. Una volta online, ogni chat compare nella tua dashboard. Una miniera d'oro. Ogni domanda che il bot ha pasticciato è una riga da aggiungere alla base di conoscenza; ogni volta che è uscito dal tono è una piccola correzione alle istruzioni. Scorri le conversazioni una volta a settimana per il primo mese.

Correggi e ripeti. L'hai visto indovinare un prezzo? Aggiungi il prezzo alla base di conoscenza. L'hai visto divagare? Affina la riga sul tono. Hai visto una domanda che dovrebbe inoltrare? Aggiungi una regola. Ogni correzione è piccola, e dopo due o tre giri il bot gestisce da solo la grande maggioranza delle domande reali.

Un esempio concreto: prima e dopo

Ecco la differenza nella pratica, per un'agenzia immobiliare.

Prima — una configurazione scarna

Istruzioni: "Sei un assistente utile per un'agenzia immobiliare." Base di conoscenza: vuota.

Un visitatore chiede: "Qual è la vostra provvigione, e qualcuno può mostrarmi l'appartamento di via Mulino questo sabato?" Il bot risponde con qualcosa di vago e generico — "Le nostre commissioni variano, contattaci per i dettagli, e la disponibilità per le visite cambia" — che è esattamente la non-risposta che manda un contatto di alto valore dritto a un'agenzia concorrente.

Dopo — una buona configurazione

Istruzioni: un ruolo (assistente di Apex Realty), un tono (professionale, reattivo, disponibile), un ambito (immobili, visite, valutazioni, provvigioni e le zone coperte) e un ripiego (per una valutazione o un'offerta specifica, prendi i dati del visitatore e passali a un agente; non promettere mai un prezzo né garantire uno slot per la visita). Base di conoscenza: le zone coperte, la struttura delle provvigioni, come funzionano visite e valutazioni, gli orari dell'ufficio e le dieci domande a cui il team risponde ogni giorno.

Stessa domanda, nuova risposta: "La nostra provvigione di vendita è dell'1,5% più IVA, e copriamo tutta la zona nord della città. Posso prendere il tuo nome e numero e far confermare una visita per sabato da un agente — faccio così?" Questa è una risposta che cattura un contatto che vale migliaia di dollari.

Nulla della seconda agenzia è più tecnico della prima. Il titolare ha solo fatto bene i due lavori: ha detto al bot come comportarsi e gli ha dato le informazioni. Per una dozzina di altri esempi concreti in settori diversi, vedi 12 esempi di chatbot per settore.

Errori comuni da evitare

• Informazioni nelle istruzioni. Prezzi e orari vanno nella base di conoscenza, non nel testo sul comportamento. Tienili separati così entrambi restano facili da gestire.
• La non-istruzione "assistente utile". "Sei un assistente utile" non dice nulla al bot. Dagli un ruolo, un tono, un ambito e un ripiego.
• Nessun ripiego. Se scrivi una sola regola, fa' che sia quella onesta: "Non lo so — ti passo a una persona".
• Riversare l'intero sito. Una pagina mirata di informazioni batte cinquanta pagine di copy di marketing.
• Conoscenza non aggiornata. Aggiorna prezzi e orari il giorno stesso in cui cambiano. Una risposta sbagliata è peggio di nessuna risposta.
• Istruzioni troppo lunghe. Oltre la mezza pagina circa, il bot inizia a perdere il filo. Vince più corto e più nitido.

Riepilogo e prossimo passo

Due lavori, tenuti separati, e un breve ciclo per rifinirli — è tutta qui l'arte.

• Le istruzioni dicono al bot come comportarsi: ruolo, tono, ambito e un ripiego onesto. Tienile entro la mezza pagina.
• La base di conoscenza contiene cosa sa il bot: orari, prezzi, politiche, FAQ. Strutturala con intestazioni, un'informazione per riga, e tienila aggiornata.
• Testa, leggi, rifinisci. Fai le domande scomode in sandbox, leggi le conversazioni reali ogni settimana, e correggi le lacune.

Fai queste tre cose e il tuo bot risponde come qualcuno che lavora davvero lì. Il modo più rapido per iniziare è partire da un template che ha già entrambe scritte per il tuo settore — guarda i piani e i crediti, oppure segui la guida alla configurazione in cinque minuti dall'inizio alla fine.