In questa pagina vengono descritte le best practice per scrivere messaggi di errore strategici che indicano all'utente come risolvere il problema, in modo da poter completare l'obiettivo.
Quando un utente interagisce con un'app Google Chat, la visualizzazione di messaggi di errore può essere un'esperienza frustrante se l'errore non è utilizzabile.
Ad esempio, il messaggio di errore An error occurred
non è utile perché non spiega cosa è andato storto, non spiega come l'utente può risolvere il problema o come può ricevere assistenza. Questa pagina descrive come strutturare i messaggi di errore
in modo che siano utili per gli utenti, mostrando esempi pratici e non attuabili.
Struttura del messaggio di errore
Un messaggio di errore interattivo ha la seguente struttura:
- Si è verificato un problema. Spiegare perché l'app di chat non riesce a completare una richiesta aiuta l'utente a risolvere il problema. Spiegare perché un errore si è verificato per creare fiducia.
- In che modo l'utente può procedere verso il proprio obiettivo. Non è mai abbastanza dire cosa è andato storto. Spiega agli utenti come superare l'errore e completare l'obiettivo.
- Come richiedere assistenza. Se l'utente è ancora bloccato, spiegagli come può ricevere ulteriore assistenza. Potrebbe essere un comando
/help
o un link alla documentazione per la tua app Chat.
Esempio di messaggio di errore: formato data non corretto
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 prevede
2021-11-19
.
Di seguito è riportata una versione del messaggio di errore con cui risponde l'app Chat, che non può essere utilizzata:
Errore risolvibile
Un utente chiede all'app Chat di pianificare una riunione con un'altra persona. L'app Chat risponde con un messaggio di errore valido e facilmente attuabile:
I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.
Puoi risolvere questo messaggio di errore per i seguenti motivi:
- Indica il problema. L'app Chat non riconosce 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 a capire cosa scrivere.
- Offre ulteriore assistenza con un comando slash
/help
. Se gli utenti sono ancora bloccati, sanno come ottenere ulteriori informazioni.
Errore di mancata adozione
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 inutilizzabile:
Enter the correct date format.
Questo messaggio di errore non è utilizzabile per i seguenti motivi:
- Non indica se ha pianificato la riunione. L'utente potrebbe essere titubante a riprogrammare la riunione o presumere che la riunione sia stata pianificata.
- Non indicano all'utente come formattare la data. Anziché supporre che gli utenti sappiano come formattare la data, dovrebbe indicare che è in attesa del formato data
yyyy-mm-dd
. - Non offre ulteriore assistenza. Se gli utenti sono bloccati e non sanno come procedere, potrebbero smettere di inviare messaggi all'app Chat.
Prova
Ora che sai come scrivere errori attuabili, puoi identificare nel seguente scenario quale di questi errori è utilizzabile:
Un'app di Chat crea eventi di calendario quando gli utenti inviano messaggi
all'app di Chat con la parola chiave schedule
. Per creare un evento di calendario, l'app Chat richiede l'autenticazione utente. Se un utente non è stato autenticato, l'app Chat risponde con un messaggio di errore.
/signin
. Per saperne di più, digita /help
.- Che cosa non ha funzionato. L'app Chat richiede l'autenticazione.
- Come procedere. Digita
/signin
per l'autenticazione. - Come richiedere assistenza Se l'utente vuole maggiori informazioni, può digitare
/help
.