Scrivere un articolo per la knowledge base e scrivere un buon articolo per la knowledge base sono due cose molto diverse. La maggior parte dei contenuti di aiuto è tecnicamente accurata ma praticamente inutilizzabile — troppo lunga, sepolta sotto contesto di cui i clienti non hanno bisogno, scritta in forma passiva come se qualcuno stesse coprendo le proprie responsabilità legali. I clienti leggono la prima frase, non trovano subito la risposta e aprono un ticket.
Questa guida parla di come scrivere articoli che funzionino: chiari, specifici e strutturati in modo da portare i clienti alla risposta prima che si arrendano.
Iniziate con la Domanda Giusta
Ogni articolo deve essere costruito attorno a una domanda o a un compito specifico. Prima di scrivere una singola frase, formulate chiaramente quella domanda — anche se non compare mai letteralmente nell'articolo.
"Come fa un cliente a reimpostare la password se ha l'autenticazione a due fattori abilitata e non riesce più ad accedere alla propria app di autenticazione?"
Questa domanda è diversa da "Come reimpostare una password" — è più specifica e circoscritta. Un articolo separato e specifico per questo caso particolare servirà i clienti meglio di un unico articolo esteso "Password e Sicurezza" che cerca di coprire tutto.
In caso di dubbio, restringete l'ambito. Potete sempre collegare gli articoli tra loro. Non potete facilmente rendere un articolo lungo e privo di focus più breve senza riscriverlo.
Usate Titoli in Formato Domanda
I titoli scritti come domande corrispondono al modo in cui i clienti cercano. Fissano anche un'aspettativa chiara: il visitatore sa esattamente a cosa risponderà l'articolo prima di cliccare.
Meno efficace:
- Reimpostazione della password
- Panoramica della fatturazione
- Autenticazione a due fattori
Più efficace:
- Come si reimposta la password?
- Come funziona la fatturazione?
- Come si abilita l'autenticazione a due fattori?
Per domande con un sintomo noto, il sintomo stesso è un ottimo titolo:
- Perché non ricevo l'email di verifica?
- Perché il mio pagamento viene rifiutato?
- Perché non riesco a vedere l'attività dei membri del mio team?
Questi corrispondono esattamente a ciò che un cliente frustrato digita in un motore di ricerca.
Rispondete alla Domanda nel Primo Paragrafo
Il primo paragrafo di un articolo della knowledge base non è il posto per contesto, storia o avvertenze. È il posto per la risposta — o almeno per un'indicazione chiara di cosa dirà l'articolo e il percorso più rapido per arrivarci.
Inizio lento:
L'autenticazione a due fattori (2FA) è un'importante misura di sicurezza che aggiunge un ulteriore livello di protezione al vostro account al di là della semplice password. In questo articolo vi guideremo attraverso il processo di abilitazione e utilizzo della 2FA sul vostro account.
Inizio rapido:
Per abilitare l'autenticazione a due fattori, andate su Impostazioni → Sicurezza e fate clic su Abilita 2FA. Scansionate il codice QR con la vostra app di autenticazione (Google Authenticator, Authy o qualsiasi app TOTP) e inserite il codice a 6 cifre per confermare.
La seconda versione risponde alla domanda in due frasi. Tutto ciò che segue — codici di recupero, risoluzione dei problemi, disabilitazione della 2FA — viene dopo che la risposta principale è stata stabilita.
Scrivete i Passaggi come Passi Numerati
Qualsiasi processo con più di due azioni deve usare un elenco numerato, non la prosa. I passi numerati sono:
- Più facili da seguire senza perdere il filo
- Più facili da scorrere per trovare dove ci si è fermati
- Meno soggetti a fraintendimenti (la sequenza è esplicita)
Versione in prosa:
Per modificare il vostro indirizzo email, dovrete andare nelle impostazioni del profilo facendo clic sull'avatar nell'angolo in alto a destra, poi selezionare Profilo. Da lì, scorrete fino alla sezione Email e fate clic su Modifica. Inserite il nuovo indirizzo email e fate clic su Salva. Riceverete un'email di conferma al nuovo indirizzo.
Formato a passi:
- Fate clic sul vostro avatar nell'angolo in alto a destra e selezionate Profilo
- Scorrete fino alla sezione Email e fate clic su Modifica
- Inserite il nuovo indirizzo email
- Fate clic su Salva
- Controllate il nuovo indirizzo email per un link di conferma e cliccatelo
La versione numerata è più rapida da leggere e più difficile da seguire male.
Mettete in Grassetto gli Elementi dell'Interfaccia e le Azioni
Quando fate riferimento a elementi dell'interfaccia — pulsanti, voci di menu, nomi di campi, nomi di pagine — metteteli in grassetto. Questo segnale visivo aiuta i clienti a scorrere rapidamente per trovare l'elemento specifico su cui fare clic o che devono cercare.
Fate clic su Salva modifiche per confermare l'aggiornamento.
Navigate su Impostazioni → Team → Invita membro.
Non mettete in grassetto frasi intere o enfasi casuali. Riservate il grassetto a: etichette dei pulsanti, voci di menu, nomi dei campi e scorciatoie da tastiera.
Usate gli Screenshot in Modo Strategico — Non Decorativo
Gli screenshot sono utili quando l'elemento dell'interfaccia descritto è difficile da trovare o quando il contesto visivo aiuta. Non sono utili quando vengono incollati automaticamente per far sembrare un articolo "completo".
Quando usare uno screenshot:
- L'elemento dell'interfaccia si trova in una posizione non ovvia
- Più elementi si assomigliano e distinguerli visivamente aiuta
- Il risultato di un'azione (un messaggio di conferma, uno stato modificato) è più facile da mostrare che da descrivere
Quando evitare lo screenshot:
- Il passaggio è "fate clic su Salva" — non è necessario uno screenshot
- L'interfaccia cambia frequentemente e non potete impegnarvi a tenere aggiornati gli screenshot
Quando usate screenshot: indicate l'elemento rilevante con una freccia, un'evidenziazione o un callout numerato. Uno screenshot a pagina intera in cui il visitatore deve trovare da solo l'elemento rilevante non è migliore di una descrizione testuale.
Scrivete per la Lettura a Colpo d'Occhio, non per la Lettura Lineare
I clienti non leggono gli articoli della knowledge base — li scorrono. Guardano i titoli, il testo in grassetto e gli elenchi numerati. Si fermano quando trovano la sezione pertinente.
Scrivete di conseguenza:
- Usate liberamente i titoli H2 e H3 per suddividere l'articolo in sezioni
- Mantenete i paragrafi brevi — tre o quattro frasi al massimo
- Usate i punti elenco per elenchi di elementi o opzioni
- Non seppellite le informazioni critiche nel mezzo di un lungo paragrafo
Ogni titolo di sezione deve descrivere di cosa tratta quella sezione. "Problemi comuni" è meno utile di "Cosa fare se non si riceve l'email di conferma".
Anticipate e Affrontate i Casi Particolari
I migliori articoli della knowledge base rispondono non solo alla domanda principale ma anche alle domande di follow-up che i clienti hanno quando il processo standard non funziona.
Dopo i passi principali, aggiungete una sezione per:
- "Cosa succede se [passo X] non funziona?"
- "Ho completato questi passaggi ma [il risultato atteso] non è avvenuto"
- "Questo processo appare diverso sul mio schermo"
Questi casi particolari rappresentano le domande che diventano ticket quando l'articolo principale non le affronta. Aggiungere una breve sezione di risoluzione dei problemi alla fine dei vostri articoli procedurali può aumentare significativamente il loro tasso di auto-risoluzione.
Adattate il Livello di Lettura al Vostro Pubblico
La maggior parte degli articoli della knowledge base rivolti ai clienti deve essere scritta a un livello di comprensione accessibile a un pubblico non tecnico. Evitate:
- Gergo specifico del vostro prodotto o settore che un nuovo cliente non riconoscerebbe
- Acronimi senza spiegazione al primo utilizzo
- Linguaggio eccessivamente formale o legalistico
Il test: un cliente che si è iscritto ieri riuscirebbe a capire questo articolo senza contesto aggiuntivo? Se no, aggiungete il contesto o semplificate il linguaggio.
Gli articoli interni — scritti per gli agenti, non per i clienti — possono usare un linguaggio più tecnico e presupporre una maggiore conoscenza del prodotto. Teneteli chiaramente separati dagli articoli pubblici.
Concludete con il Passo Successivo
Ogni articolo deve chiudersi con:
- Un passo successivo naturale: "Ora che la 2FA è abilitata, potreste voler [scaricare i codici di recupero]."
- Un percorso di escalation: "Se riscontrate ancora problemi, [contattate il nostro team di supporto] o [avviate una live chat]."
Non lasciate il visitatore bloccato alla fine dell'articolo senza una direzione ovvia. Un articolo che finisce bruscamente all'ultimo passo è un'opportunità mancata per approfondire il coinvolgimento con il vostro prodotto o per indirizzare un cliente bloccato verso la risoluzione.
Come Nura24 Supporta la Qualità degli Articoli
Il modulo knowledge base di Nura24 include un editor di testo avanzato TipTap con supporto per elenchi numerati, titoli, formattazione in grassetto, caricamento di immagini e collegamento interno agli articoli. Il feedback sugli articoli (utile / non utile) viene raccolto sulla pagina pubblica, e la funzionalità di analisi dei gap tramite AI segnala le domande poste nella live chat e nei ticket a cui nessun articolo risponde attualmente — indicando direttamente dove i nuovi contenuti sono più necessari. Gli articoli possono essere pubblicati pubblicamente o mantenuti interni (visibili solo agli agenti), supportando sia la gestione della conoscenza rivolta ai clienti che quella interna nello stesso spazio di lavoro.