In questa pagina vengono descritte le best practice per scrivere messaggi di errore strategici che indichino all'utente come risolvere il problema in modo da poter completare l'obiettivo.
Quando un utente interagisce con un'app Google Chat, incontra
può essere frustrante quando non è possibile intervenire sui messaggi di errore.
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
utili per gli utenti, mostrando esempi pratici e inattuabili.
Struttura del messaggio di errore
Un messaggio di errore su cui è possibile eseguire un'azione ha la seguente struttura:
- Cosa non ha funzionato. Spiegare perché l'app Chat non può completare una richiesta aiuta l'utente a risolvere il problema. Spiegazione del motivo di un errore crea fiducia.
- In che modo l'utente può procedere verso il raggiungimento dell'obiettivo. Non basta mai limitarsi a spiegami cosa è andato storto. Indica agli utenti come possono andare oltre l'errore e completare la procedura l'obiettivo.
- Come ricevere assistenza. Se l'utente è ancora bloccato, digli come può accedervi.
per ricevere ulteriore assistenza. Potrebbe trattarsi di un comando
/help
o di un link alla documentazione per la tua app Chat.
Esempio di messaggio di errore: formato data errato
In questo esempio, l'utente ha inserito una data in un formato
non era previsto dall'app Chat. Hanno scritto
November 19, 2021
, ma l'app Chat prevede
2021-11-19
.
Di seguito è riportata una versione con cui è possibile eseguire azioni e una versione non eseguibile del messaggio di errore che indica L'app di chat risponde con:
Errore risolvibile
Un utente chiede all'app Chat di pianificare una riunione con a un'altra persona. L'app Chat risponde con un buon 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`.
È possibile intervenire su questo messaggio di errore per i seguenti motivi:
- Dice cosa è andato storto. L'app Chat non riconoscere il formato della data.
- Spiega come correggere l'errore indicando all'utente il formato della data previsto e fornisce una data di esempio che aiuti le persone a capire cosa scrivere.
- Offre ulteriore assistenza con un comando slash
/help
. Se gli utenti sono ancora bloccati, sanno come scoprire di più.
Errore non applicabile
Un utente chiede all'app Chat di pianificare una riunione con a un'altra persona. L'app Chat risponde con un messaggio di errore inutile e inattuabile:
Enter the correct date format.
Non è possibile eseguire questo messaggio di errore per i seguenti motivi:
- Non dice se ha pianificato la riunione. L'utente potrebbe essere riluttante a riprogrammare la riunione o potrebbero presumere che la riunione sia stata programmata.
- Non spiega all'utente come formattare la data. Invece di supporre che
utenti sanno come formattare la data, la data dovrebbe essere in attesa
formato data
yyyy-mm-dd
. - Non offre ulteriore assistenza. Se gli utenti sono bloccati e non sanno come procedere, potrebbero interrompere la messaggistica all'app Chat.
Prova
Ora che sai come scrivere errori strategici, puoi identificarli nel dei seguenti errori su cui è possibile intervenire:
Un'app di Chat crea eventi nel calendario quando gli utenti inviano messaggi
l'app Chat con la parola chiave schedule
. A
creare un evento nel calendario, l'app Chat richiede
autenticazione. Se un utente non è stato autenticato,
L'app Chat risponde con un messaggio di errore.
/signin
. Per scoprire di più, digita /help
.- Qual è il problema. L'app Chat richiede autenticazione.
- Come procedere Digita
/signin
per l'autenticazione. - Come richiedere assistenza. Se l'utente vuole maggiori informazioni, può digitare
/help
.