Prenotate una demo
Italiano

Per responsabili del supporto tecnico e della documentazione

Knowledge base o troubleshooting guidato: a che cosa serve ciascuno

La maggior parte dei produttori pubblica già i manuali online, eppure gli installatori continuano a telefonare. Perché una raccolta di documenti corretti non equivale a una risposta, dove la knowledge base è lo strumento giusto e dove un percorso guidato funziona meglio.

Raccoglitori ad anelli su uno scaffale d’acciaio in un’officina, uno pieno di pagine irte di linguette colorate.

La maggior parte dei produttori ha già messo online i manuali, spesso in un portale ben organizzato. Gli installatori telefonano comunque. Non perché i documenti siano sbagliati. Una knowledge base risponde alla domanda “dove è scritto?”. Un installatore in cantiere ne pone un’altra: “che cosa faccio adesso?”.

In breve

  • Una knowledge base è una biblioteca: è fatta per cercare e leggere. Il troubleshooting guidato è una conversazione: è fatto per agire, un passaggio alla volta.
  • In un sondaggio di Gartner, solo il 14% dei problemi di assistenza è stato risolto completamente in self-service, e il 36% di quelli molto semplici. Nel 43% dei tentativi falliti, i clienti non trovavano contenuti pertinenti.
  • Usate una knowledge base per il materiale di consultazione. Usate un percorso guidato quando la risposta dipende da ciò che vede l’installatore e l’ordine conta.
  • Non sono alternativi. Le guide nascono dagli stessi documenti, che restano la fonte di riferimento.
dei problemi di assistenza clienti è stato risolto completamente in self-service
14%
Gartner, agosto 2024
anche per i problemi che i clienti definivano molto semplici
36%
Gartner, agosto 2024
dei fallimenti del self-service: i clienti non trovavano contenuti pertinenti
43%
Gartner, agosto 2024

Due strumenti per due domande

Prendete un installatore davanti a una centralina per porte che mostra un codice di errore. Con una knowledge base, il lavoro per passare dal codice alla soluzione spetta a lui: cercare, scegliere un documento, trovare la pagina, capire quale variante ha davanti, poi ricostruire i passaggi. Con un percorso guidato, è la stessa documentazione a fare questo lavoro per lui, una domanda alla volta.

Lo stesso guasto, due percorsi verso la soluzione

Illustrazione

Knowledge base 6 passaggi, tutti a carico dell’installatore

  1. CercaDigita “E04” nel portale
  2. SceglieDodici documenti lo citano
  3. ApreUn manuale di 86 pagine sul telefono
  4. TrovaLa tabella dei guasti a pagina 61
  5. DecideQuale delle tre varianti è installata?
  6. AgiscePassaggi a pagina 61, impostazioni a pagina 34

Troubleshooting guidato 5 passaggi, le domande le fa la guida

  1. ChiedeInvia “E04” in un messaggio
  2. RispondeTocca “Monofase”
  3. AgiscePassaggio 1 di 3, per quella variante
  4. AgiscePassaggio 2, con lo schema
  5. FattoRisolto, o passato a una persona
Prodotto e manuale inventati. I numeri di pagina mostrano il tipo di ricerca che richiede un manuale lungo; non sono tratti da un documento reale.

Perché documenti corretti generano comunque chiamate

Il self-service raramente fallisce perché mancano le informazioni. Gartner ha intervistato 5.728 clienti a dicembre 2023 e ha rilevato che solo il 14% dei problemi di assistenza era stato risolto completamente in self-service. Anche per i problemi che i clienti stessi definivano molto semplici, la quota era del 36%. Nel 43% dei tentativi falliti, non riuscivano a trovare contenuti pertinenti al proprio problema. Sono clienti di vari settori, non installatori, ma un installatore con un codice di errore si trova in una posizione più difficile, non più facile.

La maggior parte dei tentativi di self-service finisce altrove

Quota di problemi risolti completamente in self-service

  • Tutti i problemi14%
  • Problemi che i clienti definivano molto semplici36%
Sondaggio su 5.728 clienti, dicembre 2023. Clienti di vari settori, non specificamente installatori.Fonte: Gartner, agosto 2024

Anche quando si trova la pagina giusta, raramente la si legge per intero. L’analisi della navigazione web reale di Jakob Nielsen ha stimato che le persone leggono al massimo il 28% delle parole di una pagina media, e più probabilmente circa il 20%. Un manuale scritto per essere completo è lungo per definizione. Letto a frammenti, sul telefono, con poca luce, è facile perdere l’unica riga che dice “solo sui modelli trifase”.

Il problema non è che la risposta manchi. È che l’installatore deve ricostruirla da solo.

Dove la knowledge base è lo strumento giusto

Niente di tutto questo rende la knowledge base un errore. Per il materiale di consultazione è perfetta: una scheda tecnica, un certificato, un elenco ricambi o un disegno di montaggio sono cose che si vogliono trovare, guardare e conservare. La differenza sta in due aspetti: se la risposta dipende da ciò che vede l’installatore e se l’ordine dei passaggi conta.

Quale strumento per quale domanda

Due test: la risposta dipende da ciò che vede l’installatore? L’ordine conta?

Procedura

Da seguire in ordine

Una sequenza di messa in servizio per un prodotto

Entrambi; una guida tiene il segno

Diagnosi

Che cosa non va, e adesso?

Codici di errore, una porta che si ferma, un sensore che non si resetta

Guidato

Consultazione

Da cercare

Dimensioni, schede tecniche, certificati, elenchi ricambi

Knowledge base

Selezione

Quale vale nel mio caso?

Il parametro per questa variante e questo utilizzo

Guidato

Un modo di classificare le domande di supporto, non una misurazione.

Classificate così, la maggior parte delle domande che arrivano alla linea tecnica di un produttore finisce sul lato destro. Sono le domande attorno a cui è costruito questo sito: configurazione dei parametri, impostazione dei finecorsa, cablaggio, coste di sicurezza e fotocellule, messa in servizio e codici di errore.

Un installatore chiedeMeglio servito da
Esiste una dichiarazione di conformità per questo modello?Knowledge base
Quali sono le dimensioni di montaggio?Knowledge base
Quale parametro imposta il tempo di chiusura automatica sulla mia variante?Guidato
Come imposto i finecorsa di apertura e chiusura?Guidato
Dove si collega la costa di sicurezza e come la verifico?Guidato
Il display mostra E04. E adesso?Guidato

Non è un’idea nuova. Da tempo la documentazione aerospaziale tratta la ricerca guasti come una struttura anziché come testo: la specifica S1000D per le pubblicazioni tecniche prevede una struttura dedicata alle procedure di isolamento dei guasti, che alcuni sistemi di visualizzazione rappresentano come diagrammi di isolamento dei guasti. La novità è che oggi quella struttura può raggiungere l’installatore sul telefono che ha già in mano.

Uno spesso manuale di installazione ad anelli aperto su un banco di lavoro accanto a una centralina per porte senza coperchio, con diverse pagine segnate da linguette colorate
Tutte le risposte sono lì. Il lavoro è passare dal sintomo alla pagina giusta, per la variante giusta, nell’ordine giusto.

Non l’uno o l’altro

Il modo utile di considerarli è come un unico corpo di documentazione usato in due modi. Manuali, bollettini e disegni restano nella knowledge base, dove vengono aggiornati e dove le persone vanno a leggerli. I percorsi guidati nascono da questi documenti per le domande che richiedono di agire più che di leggere, e ogni passaggio può rimandare alla pagina da cui proviene.

Un solo insieme di documenti, usato in due modi

Manuali, bollettini e disegni
Knowledge basePer lettura e consultazione
Percorsi guidatiPer diagnosi e configurazione in cantiere
Le domande a cui le guide non sanno rispondere mostrano dove i documenti vanno migliorati

C’è un secondo vantaggio. Una knowledge base può dirvi quali pagine sono state aperte, ma non se il lettore ha trovato ciò che cercava. Una guida sa dove si è fermato ogni installatore, che cosa ha scelto e quali domande ha dovuto passare a una persona: un elenco preciso dei punti in cui la documentazione non è chiara.

Lingo crea percorsi guidati a partire dai manuali e dai bollettini del produttore, e il team tecnico approva ciascuno di essi prima che gli installatori lo vedano. Scoprite come Lingo trasforma un manuale in una guida, oppure guardatelo applicato ai codici di errore e alla configurazione dei parametri.

Fonti

  1. Gartner survey finds only 14% of customer service issues are fully resolved in self-serviceGartner, 19 agosto 2024. Sondaggio su 5.728 clienti, dicembre 2023. Clienti di vari settori.
  2. How little do users read?Jakob Nielsen, Nielsen Norman Group, 5 maggio 2008. Analisi dei dati di navigazione di Weinreich, Obendorf, Herder e Mayer, ACM Transactions on the Web, 2008. Il 28% è un limite superiore.
  3. S1000D data module typesDocumentazione di Adobe FrameMaker, consultata a ottobre 2026. Il data module dei guasti e i diagrammi di isolamento dei guasti.

Le domande più comuni

Qual è la differenza tra una knowledge base e il troubleshooting guidato?

Una knowledge base è una biblioteca: contiene i documenti corretti e permette di cercarli e leggerli. Il troubleshooting guidato è una conversazione: pone una domanda alla volta su ciò che l’installatore vede e indica il passaggio documentato successivo per quella risposta. La prima serve a trovare le informazioni, il secondo ad agire di conseguenza.

Perché gli installatori telefonano ancora se i manuali sono online?

Perché trovare la pagina giusta, per la variante giusta, sul telefono, in cantiere, è più lento che telefonare. In un sondaggio di Gartner su 5.728 clienti pubblicato ad agosto 2024, solo il 14% dei problemi di assistenza è stato risolto completamente in self-service, e nel 43% dei casi i clienti non trovavano contenuti pertinenti al proprio problema.

Il troubleshooting guidato sostituisce la knowledge base?

No. Le guide nascono dagli stessi manuali e bollettini, quindi la documentazione resta la fonte di riferimento. Il materiale di consultazione, come schede tecniche, certificati ed elenchi ricambi, è sempre meglio tenerlo in una biblioteca che le persone possono sfogliare e consultare.

Quali domande di supporto si prestano meglio al troubleshooting guidato?

Le domande in cui la risposta dipende da ciò che l’installatore ha davanti e l’ordine dei passaggi conta: codici di errore, messa in servizio, impostazioni dei parametri per una specifica variante, cablaggio e verifiche dei dispositivi di sicurezza.

Lingo

Lingo trasforma i manuali dei produttori in guide passo passo che gli installatori seguono su WhatsApp, approvate dal team tecnico del produttore stesso.