Questa pagina descrive le best practice per scrivere messaggi di errore strategici che indicano all'utente come risolvere il problema in modo che possa raggiungere il suo obiettivo.
Quando un utente interagisce con un'app Google Chat, la visualizzazione di messaggi di errore può essere frustrante se l'errore non è strategico.
Ad esempio, il messaggio di errore An error occurred non è utile perché il
messaggio non spiega cosa è andato storto, come l'utente può risolvere il problema o come
l'utente può ricevere assistenza. Questa pagina descrive come strutturare i messaggi di errore in modo che siano utili agli utenti mostrando esempi strategici e non strategici.
Struttura del messaggio di errore
Un messaggio di errore strategico ha la seguente struttura:
- Cosa è andato storto. Indicare il motivo per cui l'app Chat non può completare una richiesta aiuta l'utente a risolvere il problema. Spiegare perché si è verificato un errore crea fiducia.
- Come l'utente può procedere per raggiungere il suo obiettivo. Non è mai sufficiente dire cosa è andato storto. Indica agli utenti come superare l'errore e raggiungere il loro obiettivo.
- Come ricevere assistenza. Se l'utente è ancora bloccato, indicagli come può ricevere ulteriore assistenza. Potrebbe trattarsi di un comando
/helpo di un link alla documentazione della tua app Chat.
Esempio di messaggio di errore: formato data errato
In questo esempio, l'utente ha inserito una data in un formato non previsto dall'app Chat. Ha scritto November 19, 2021, ma l'app Chat si aspetta 2021-11-19.
Di seguito sono riportate una versione strategica e una non strategica del messaggio di errore a cui risponde l'app Chat:
Errore strategico
Un utente chiede all'app Chat di pianificare una riunione con un'altra persona. L'app Chat risponde con un messaggio di errore strategico:
I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.
Questo messaggio di errore è strategico per i seguenti motivi:
- Indica cosa è andato storto. L'app Chat non riconosce il formato della data.
- Spiega come correggere l'errore indicando all'utente il formato della data previsto e fornendo una data di esempio che aiuta le persone a capire cosa scrivere.
- Offre ulteriore assistenza con un comando slash
/help. Se gli utenti sono ancora bloccati, sanno come saperne di più.
Errore non strategico
Un utente chiede all'app Chat di pianificare una riunione con un'altra persona. L'app Chat risponde con un messaggio di errore non utile e non strategico:
Enter the correct date format.
Questo messaggio di errore non è strategico per i seguenti motivi:
- Non indica se la riunione è stata pianificata. L'utente potrebbe esitare a riprogrammare la riunione o potrebbe presumere che la riunione sia stata pianificata.
- Non indica all'utente come formattare la data. Invece di presumere che
gli utenti sappiano come formattare la data, dovrebbe indicare che è previsto il
formato della data
yyyy-mm-dd. - Non offre ulteriore assistenza. Quando gli utenti sono bloccati e non sanno come procedere, potrebbero smettere di inviare messaggi all'app Chat.
Prova
Ora che sai come scrivere errori strategici, riesci a identificare nello scenario seguente quale di questi errori è strategico:
Un'app Chat crea eventi di calendario quando gli utenti inviano un messaggio all'app Chat con la parola chiave schedule. Per creare un evento di calendario, l'app Chat richiede l'autenticazione dell'utente. Se un utente non è stato autenticato, l'app Chat risponde con un messaggio di errore.
/signin. To learn more, type /help.- Cosa è andato storto. L'app Chat richiede l'autenticazione.
- Come procedere. Digita
/signinper eseguire l'autenticazione. - Come ricevere assistenza. Se l'utente vuole saperne di più, può digitare
/help.