Scrivere messaggi di errore strategici

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`.

Esempio di messaggio di errore che indica all'utente cosa non ha funzionato, come procedere e come richiedere assistenza.

È 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.

Esempio di messaggio di errore che non fornisce informazioni strategiche.

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.

Per quale messaggio di errore è possibile intervenire?
Affinché io possa pianificare la riunione, devi accedere digitando /signin. Per scoprire di più, digita /help.
Questo messaggio di errore può essere preso in considerazione perché indica quanto segue:
  • 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.
Devi autenticarti.
Questo messaggio di errore non è utilizzabile perché non indica come autenticarsi.
Accedi.
Questo messaggio di errore non è utilizzabile perché non indica come accedere Ciò significa che l'utente è disconnesso, invece di dire chiaramente il che crea confusione.
Impossibile pianificare la riunione.
Questo messaggio di errore non è utilizzabile perché non comunica all'utente perché non è possibile pianificare la riunione o come l'utente può procedere. Nessun aiuto in cui viene fornito il valore.