Blog Best practice

Knowledge base e portale self-service: guida

Come progettare una knowledge base utile, organizzare gli articoli e offrire un portale self-service che riduca le richieste ripetitive.

Knowledge base e portale self-service: guida
In questo articolo
  1. Cos'è una knowledge base?
  2. I due tipi di knowledge base
  3. Cos'è un portale self-service?
  4. Esempio pratico
  5. Perché il self-service funziona
  6. Un articolo lavora anche di notte
  7. I clienti vogliono autonomia
  8. Come strutturare una knowledge base efficace
  9. 1. Categorie chiare
  10. 2. Titoli che rispondono a domande
  11. 3. Contenuti che si possono seguire
  12. 4. Ricerca efficace
  13. 5. Feedback sui contenuti
  14. Tipi di contenuti per la knowledge base
  15. 1. Articoli (guide)
  16. 2. FAQ
  17. 3. Tutorial
  18. 4. Glossario
  19. 5. Download
  20. 6. Video
  21. Come creare contenuti che funzionano
  22. Parti dalle domande reali
  23. Scrivi per chi non sa nulla
  24. Aggiorna regolarmente
  25. Portale self-service: elementi essenziali
  26. 1. Homepage pulita
  27. 2. Branding coerente
  28. 3. Leggibile da telefono
  29. 4. Accesso al supporto umano
  30. 5. Area ticket personale
  31. Metriche da monitorare
  32. Ricerche che finiscono in un articolo
  33. Giudizio sui singoli articoli
  34. Ticket in meno su una domanda
  35. Ricerche che non portano da nessuna parte
  36. Errori comuni da evitare
  37. 1. KB nascosta
  38. 2. Troppi contenuti, poca qualità
  39. 3. Linguaggio troppo tecnico
  40. 4. Nessun aggiornamento
  41. 5. Ricerca che non funziona
  42. Da zero ai primi articoli
  43. Primo passo: raccogliere le domande
  44. Secondo passo: scrivere
  45. Terzo passo: il portale
  46. Quarto passo: prova interna
  47. Quinto passo: pubblicazione
  48. Conclusione

Una knowledge base efficace non è un archivio di FAQ. È una parte del servizio clienti: intercetta le domande prima del ticket, offre risposte coerenti fuori orario e dà agli operatori una fonte comune durante la conversazione.

Per ottenere questo risultato servono architettura dei contenuti, ricerca, governance editoriale e un portale progettato intorno alle intenzioni del cliente. Questa guida mostra come impostarli.

Cos'è una knowledge base?

Una knowledge base (KB) è una libreria digitale di articoli, guide e FAQ che risponde alle domande più frequenti dei tuoi clienti.

Raccoglie in un unico ambiente contenuti pubblici per i clienti e procedure riservate al team.

I due tipi di knowledge base

1. Interna, per il team

  • Procedure operative
  • Script di risposta
  • Guide tecniche
  • Note su casi particolari

Aiuta il team a rispondere più velocemente e in modo coerente.

2. Esterna, per i clienti

  • FAQ pubbliche
  • Guide all'uso del prodotto
  • Tutorial passo-passo
  • Glossario termini

Permette ai clienti di trovare risposte senza contattarti.

Cos'è un portale self-service?

Il portale self-service è l'interfaccia pubblica dove i clienti accedono alla knowledge base e possono:

  • Cercare articoli e guide
  • Consultare FAQ
  • Scaricare documentazione
  • Aprire ticket (se non trovano risposta)
  • Vedere lo stato delle loro richieste

È il centro assistenza della tua azienda, raggiungibile a qualunque ora. In Uppo è il portale self-service, con opzioni di dominio personalizzato secondo il piano e la configurazione.

Esempio pratico

  1. Cliente ha un problema alle 23:00
  2. Visita il tuo portale self-service
  3. Cerca "reso prodotto"
  4. Trova l'articolo "Come effettuare un reso in 3 step"
  5. Segue le istruzioni e risolve da solo
  6. Non ha dovuto aspettare risposta del supporto

Il risultato: il cliente ha risolto, e al team non è arrivato niente.

Perché il self-service funziona

Un articolo lavora anche di notte

Una risposta scritta una volta sola resta disponibile a qualunque ora, per chiunque, senza personale di notte. È la parte del supporto che regge la crescita senza aggiungere persone: la stessa leva che compare fra le sette in come ridurre i tempi di risposta.

I clienti vogliono autonomia

Il cliente moderno:

  • È abituato a cercare su Google
  • Non vuole aspettare in coda
  • Preferisce risolvere da solo se possibile
  • Contatta il supporto solo per problemi complessi

Offrire self-service non è "abbandonare" il cliente, è rispettare il suo tempo.

Come strutturare una knowledge base efficace

1. Categorie chiare

Organizza i contenuti in modo logico:

📁 Iniziare
   ├── Creare un account
   ├── Primo accesso
   └── Configurazione iniziale

📁 Pagamenti e Fatturazione
   ├── Metodi di pagamento
   ├── Fatture e ricevute
   └── Modificare piano

📁 Spedizioni e Resi
   ├── Tempi di spedizione
   ├── Tracciare ordine
   └── Effettuare un reso

📁 Problemi Tecnici
   ├── Password dimenticata
   ├── Errori comuni
   └── Contattare supporto

2. Titoli che rispondono a domande

Sbagliato:

  • "Spedizioni"
  • "Account"
  • "Pagamenti"

Giusto:

  • "Quanto tempo impiega la spedizione?"
  • "Come creo un account?"
  • "Quali metodi di pagamento accettate?"

I titoli dovrebbero essere le domande che i clienti cercano su Google.

3. Contenuti che si possono seguire

Ogni articolo deve rispondere a una domanda specifica con istruzioni chiare:

Struttura consigliata:

  1. Risposta breve (1-2 frasi) subito visibile
  2. Passi dettagliati numerati
  3. Screenshot dove utile
  4. Note/Avvisi per casi particolari
  5. Link correlati ad altri articoli

Esempio:

Come reimpostare la password

Puoi reimpostare la password dalla pagina di login cliccando "Password dimenticata".

Passaggi:

  1. Vai su login.esempio.com
  2. Clicca "Password dimenticata"
  3. Inserisci la tua email
  4. Controlla la casella email (anche spam)
  5. Clicca il link nel messaggio
  6. Scegli una nuova password

Nota: Il link scade dopo 24 ore.

Articoli correlati:

  • Come modificare l'email dell'account
  • Problemi di accesso

4. Ricerca efficace

Una KB è inutile se i clienti non trovano quello che cercano.

Cosa deve fare la ricerca:

  • cercare nel titolo e nel testo, non solo nel titolo
  • suggerire mentre si digita
  • capire i sinonimi: "reso", "restituzione", "restituire"
  • ordinare i risultati per pertinenza

Quando la ricerca smette di inseguire la parola esatta e cerca il significato entra in gioco l'AI: quello che funziona e quello che no è in AI nel customer support.

5. Feedback sui contenuti

Aggiungi a ogni articolo:

"Questo articolo ti è stato utile?" [Sì] [No]

Se molti dicono "No", l'articolo va migliorato.

Tipi di contenuti per la knowledge base

1. Articoli (guide)

Contenuti lunghi e dettagliati su argomenti specifici.

Quando usarli:

  • Procedure complesse
  • Guide configurazione
  • procedure consigliate

2. FAQ

Domande e risposte brevi e dirette.

Quando usarle:

  • Domande con risposta secca ("Quanto costa?")
  • Dubbi comuni pre-acquisto
  • Informazioni rapide

3. Tutorial

Guide passo-passo con screenshot o video.

Quando usarli:

  • Onboarding nuovi utenti
  • Funzionalità complesse
  • Procedure visuali

4. Glossario

Definizioni di termini tecnici o specifici del settore.

Quando usarlo:

  • Prodotti tecnici
  • Settori con gergo specifico
  • Evitare confusione su terminologia

Alcuni helpdesk evidenziano da soli i termini del glossario dentro gli articoli e ne mostrano la definizione al passaggio del mouse.

5. Download

File da scaricare: manuali, moduli, modelli.

Quando usarli:

  • Documentazione tecnica PDF
  • Moduli da compilare
  • modelli e materiali

6. Video

Tutorial video per procedure complesse.

Quando usarli:

  • Dimostrazioni prodotto
  • configurazione guidata
  • Spiegazioni visuali

Come creare contenuti che funzionano

Parti dalle domande reali

Non inventare gli articoli. Analizza:

  1. Ticket passati: Quali domande ricorrono?
  2. Ricerche fallite: Cosa cercano i clienti senza trovare risposta?
  3. Team supporto: Quali domande li annoiano di più?
  4. Concorrenti: cosa coprono nei loro centri assistenza?

Scrivi per chi non sa nulla

  • Evita gergo tecnico (o spiegalo)
  • Assumi zero conoscenza del prodotto
  • Usa frasi brevi e liste puntate
  • Aggiungi screenshot per ogni passaggio

Aggiorna regolarmente

Una knowledge base non aggiornata è peggio di una knowledge base che non esiste: manda il cliente a fare una cosa che non funziona più.

Cosa rivedere, e quando:

  • dopo ogni rilascio, gli articoli toccati dalla modifica
  • ogni mese, gli articoli che raccolgono più "non mi è stato utile"
  • i contenuti che non servono più: archiviali
  • le domande nuove che si ripetono: scrivine l'articolo

Portale self-service: elementi essenziali

1. Homepage pulita

  • Barra di ricerca prominente
  • Categorie principali visibili
  • Articoli più letti/utili
  • Accesso rapido al supporto umano

2. Branding coerente

Il portale deve sembrare parte del tuo sito:

  • Logo aziendale
  • Colori del brand
  • Stesso stile grafico
  • Dominio personalizzato (help.tuodominio.it)

3. Leggibile da telefono

Molti ci arrivano dallo smartphone. Il portale deve adattarsi allo schermo, avere un testo leggibile senza ingrandire e una ricerca usabile col pollice.

4. Accesso al supporto umano

Se il self-service non basta, deve essere facile contattare un umano:

  • Pulsante "Contattaci" sempre visibile
  • Form pre-compilato con contesto
  • una chat sul sito, se la usi

5. Area ticket personale

Se il cliente ha un account:

  • Vedere i propri ticket aperti
  • Controllare lo stato
  • Aggiungere informazioni
  • Storico richieste passate

Metriche da monitorare

Ricerche che finiscono in un articolo

Ricerche con clic su un articolo / ricerche totali × 100

Non esiste una soglia valida per tutti: quello che conta è il confronto con il tuo mese precedente. Se il numero scende, i contenuti non stanno rispondendo alle domande che la gente cerca.

Giudizio sui singoli articoli

Giudizi "utile" / giudizi totali × 100

Guardalo per articolo, non in media: la media nasconde proprio quello che va riscritto. Gli articoli in fondo alla classifica sono la tua lista di lavoro.

Ticket in meno su una domanda

(Ticket prima dell'articolo − ticket dopo) / ticket prima × 100

Misuralo su una singola domanda ricorrente, non sul totale: sul totale ci sono dentro troppe cose per attribuire il merito a un articolo.

Ricerche che non portano da nessuna parte

Le ricerche senza risultati aiutano a individuare argomenti da coprire o termini da aggiungere ai contenuti. Una ricerca che restituisce risultati ma non riceve clic è un segnale diverso e va analizzata separatamente.

Errori comuni da evitare

1. KB nascosta

Se i clienti non la trovano, non la usano.

Cosa fare: un collegamento nell'intestazione del sito, nelle email di conferma e nell'area riservata.

2. Troppi contenuti, poca qualità

Pochi articoli scritti bene valgono più di molti scritti in fretta: quelli in fretta si contraddicono e nessuno se ne accorge.

Cosa fare: parti dalle domande che ricevi davvero più spesso, prese dai tuoi ticket, e fermati lì finché quelle non sono coperte bene.

3. Linguaggio troppo tecnico

"Effettuare il provisioning dell'account" → "Creare l'account"

Cosa fare: falli rileggere a qualcuno che non conosce il prodotto.

4. Nessun aggiornamento

Istruzioni che rimandano a un pulsante che non esiste più.

Cosa fare: fissa una revisione periodica e mettila in calendario, altrimenti non succede.

5. Ricerca che non funziona

Il cliente cerca "reso" e non trova nulla perché l'articolo si intitola "Politica di restituzione".

Cosa fare: aggiungi i sinonimi e prova tu stesso le ricerche, con le parole che userebbe un cliente.

Da zero ai primi articoli

Primo passo: raccogliere le domande

  • esporta i ticket degli ultimi mesi
  • estrai le domande che si ripetono
  • raggruppale per categoria

Secondo passo: scrivere

  • comincia dalle domande più frequenti
  • usa sempre la stessa struttura: risposta breve, poi i passaggi, poi le eccezioni
  • aggiungi immagini dove servono davvero

Terzo passo: il portale

  • crea le categorie
  • pubblica gli articoli
  • adatta grafica e dominio
  • prova la ricerca con le parole dei clienti

Quarto passo: prova interna

  • fallo usare al team prima che ai clienti
  • raccogli le obiezioni
  • correggi quello che salta subito all'occhio

Quinto passo: pubblicazione

  • metti i collegamenti sul sito e nelle email
  • dillo ai clienti
  • guarda le ricerche senza risultato, ogni settimana

Conclusione

Una knowledge base fa quattro cose: toglie al team le domande che si ripetono, dà al cliente una risposta anche quando l'ufficio è chiuso, cresce senza aggiungere persone e fa sì che tutti ricevano la stessa risposta corretta.

Il momento per iniziare è prima che il volume diventi ingestibile, non dopo. E se stai ancora scegliendo lo strumento con cui farla, le voci da verificare sono nella checklist per scegliere l'helpdesk giusto.

Uppo

Dalla teoria a un customer service che funziona.

Centralizza le conversazioni, assegna responsabilità chiare e controlla tempi e qualità da un unico helpdesk.

Prova Uppo gratis Parla con il team