Blog

Come creare una guida per il cliente da una registrazione

Scritto da InSnap · Pubblicato · assistenza clienti, guida passo passo, documentazione, registrazione schermo

Come creare una guida per il cliente da una registrazione

Registra l'operazione una volta sola e trasformala in una guida che il cliente può seguire: quali passaggi tenere, cosa nascondere e come esportarla.

I team di assistenza, i team di onboarding e gli account manager passano una quantità sorprendente di tempo a scrivere due volte le stesse istruzioni: una come risposta, una come documento che poi nessuno trova. Registrare l'operazione una volta e trasformare la registrazione in una guida elimina questa duplicazione.

Il flusso di lavoro qui sotto presuppone il registratore di guide di InSnap, che scatta uno screenshot a ogni clic e lo trasforma in un passaggio. La struttura — registra, elimina il superfluo, assegna i titoli, oscura, esporta — funziona con qualsiasi strumento che faccia la stessa cosa.

Registra l'operazione, non la spiegazione

Avvia la registrazione della guida, poi esegui l'operazione a velocità normale. Non commentare a voce davanti allo schermo e non aprire un documento da leggere: la registrazione è materia prima, non l'articolo finito.

Due abitudini rendono il risultato molto più facile da montare:

  • Usa lo schermo vero. Registra nel contesto del cliente, non in una demo finta, così gli screenshot corrispondono a ciò che la persona vedrà.
  • Esegui l'operazione in ordine. Ogni clic diventa un passaggio nella sequenza in cui è avvenuto, che è l'ordine di cui ha bisogno chi legge.

Ferma la registrazione quando l'operazione è finita. Tutto ciò che viene dopo è montaggio, ed è più veloce che registrare ancora.

Elimina il superfluo prima di scrivere una sola parola

Una guida registrata contiene sempre rumore: il passaggio di accesso, la ricerca andata a vuoto, la finestra trascinata al suo posto. Taglia prima queste parti, perché scrivere i titoli di passaggi che stai per eliminare è fatica sprecata.

  • Trascina i passaggi per riordinarli.
  • Elimina i passaggi che non insegnano nulla.
  • Nascondi un passaggio che serve per il contesto ma distrarrebbe, invece di eliminarlo.

Una registrazione di sedici passaggi di solito diventa di otto o nove. È il risultato giusto, non il segno che hai registrato male.

REGISTRARE UN'OPERAZIONE IN PASSAGGI

Scrivi titoli che si possano scorrere in fretta

I titoli predefiniti vengono dal controllo su cui hai fatto clic: sono un buon punto di partenza e una pessima risposta finale. «Pulsante Salva» non dice nulla al lettore su perché sta salvando.

Riscrivi ogni titolo come un'istruzione:

PredefinitoMeglio
SalvaSalva la bozza prima di cambiare i permessi
ImpostazioniApri Account e licenza
ClicInserisci il codice di attivazione che hai ricevuto via email

Al contrario, la nota sotto ogni passaggio dovrebbe spiegare la parte che nessuno può vedere in uno screenshot: cosa succede dopo, quale valore va inserito, cosa fare se il pulsante è disattivato.

Modificare titoli e note

Oscura prima che la guida esca dalla tua macchina

Le guide per i clienti sono il posto in cui succedono gli errori di privacy. Una registrazione di assistenza su un account reale contiene nomi veri, indirizzi email veri e spesso un numero d'ordine vero. Una volta che quel PDF è nella casella del cliente, o su un disco condiviso, è fuori.

InSnap ha una soluzione in un clic: disegna un mosaico sull'area sensibile in un passaggio, poi fai clic su Applica il mosaico a tutti i passaggi. Il mosaico viene copiato su ogni passaggio nella stessa posizione relativa, adattato alla dimensione dell'immagine di ciascun passaggio.

Controlla ogni passaggio dopo. Se la pagina è scorsa tra un clic e l'altro, la stessa riga si è spostata, e il mosaico copiato finirà sullo spazio vuoto lasciando i dati visibili. Sistema quei passaggi uno per uno.

OSCURARE LA STESSA AREA IN TUTTI I PASSAGGI

Aggiungi la struttura che serve a chi legge

Un muro di passaggi è intimidatorio. Raggruppa l'operazione così che chi legge sappia dove si trova:

  • Sotto-passaggi per le piccole azioni dentro un'unica idea — espandere un menu, poi scegliere una voce.
  • Riquadri per la cosa in cui è facile sbagliarsi. Usa un avviso per la perdita di dati, una nota per il contesto.
  • Una copertina con titolo, data e chi l'ha scritta.

Poi esporta nel formato che chi legge aprirà davvero. Per un cliente di solito è il PDF. Per un runbook interno, il Markdown nel repository. Per una presentazione di formazione, PowerPoint.

Aggiungere sotto-passaggi e riquadri

Invia la guida, non la registrazione

Una registrazione va guardata; una guida si può scorrere e cercare. Quando l'obiettivo è «il cliente deve riuscire a farlo da solo», la guida è l'artefatto migliore — e gli screenshot la rendono utilizzabile durante una telefonata di assistenza, dove guardare un video non è pratico.

Tieni la registrazione se l'operazione implica movimento — trascinamenti, animazioni, una sequenza più chiara in movimento. Altrimenti la guida la sostituisce.

Domande frequenti

Posso registrare una guida e modificarla dopo?

Sì. L'editor delle guide conserva i passaggi registrati e i loro screenshot, quindi titoli, note, ordine, passaggi nascosti e mosaici si possono cambiare tutti dopo la registrazione. Gli screenshot originali non vengono mai sovrascritti.

Come impedisco che i dati di un cliente finiscano nella guida?

Oscura prima di esportare. Disegna un mosaico su un passaggio, usa Applica il mosaico a tutti i passaggi, poi controlla ogni passaggio — soprattutto quelli acquisiti dopo che la pagina è scorsa — e correggi le posizioni che si sono spostate.

Quale formato di esportazione devo inviare a un cliente?

PDF per i clienti e per chiunque sia fuori dall'azienda. HTML per una pagina di aiuto ospitata da te, Markdown per un repository, Word o PowerPoint per materiale di formazione. Tutti i formati contengono gli stessi passaggi e le stesse immagini.

Una guida registrata è meglio di una scritta?

Per tutto ciò che accade sullo schermo, sì — lo screenshot toglie l'ambiguità di «fai clic sul pulsante a destra». Le istruzioni scritte restano migliori per policy, contesto e tutto ciò che non è un clic.

Il tuo prossimo screenshot è a una scorciatoia di distanza.

macOS 14.4+ (Apple Silicon e Intel) · Windows 10+ (64 bit)