Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina descrive le best practice per scrivere messaggi di errore utili 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, imbattersi in
messaggi di errore può essere un'esperienza frustrante quando l'errore non è risolvibile.
Ad esempio, il messaggio di errore An error occurred non è utile perché non spiega cosa è andato storto, 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 agli utenti mostrando esempi di azioni possibili e non possibili.
Struttura del messaggio di errore
Un messaggio di errore pratico ha la seguente struttura:
Che cosa non ha funzionato. Spiegare perché l'app Chat non può
completare una richiesta aiuta l'utente a risolvere il problema. Spiegare il motivo per cui si è verificato un errore
crea fiducia.
Come l'utente può procedere verso il suo obiettivo. Non basta mai dire
cosa è andato storto. Spiega agli utenti come superare l'errore e completare
il loro obiettivo.
Come ricevere assistenza. Se l'utente è ancora bloccato, indica come può ricevere
ulteriore assistenza. Può trattarsi di un comando /help o di un link alla documentazione della tua app di chat.
Messaggio di errore di esempio: formato della data non corretto
In questo esempio, l'utente ha inserito una data in un formato
non previsto dall'app Chat. Hanno scritto
November 19, 2021, ma l'app Chat si aspetta
2021-11-19.
Ecco una versione del messaggio di errore che richiede un'azione e una che non la richiede, a cui
risponde l'app Chat:
Errore strategico
Un utente chiede all'app Chat di programmare una riunione con
un'altra persona. L'app Chat risponde con un messaggio di errore
valido e utile:
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 è azionabile per i seguenti motivi:
Indica cosa non ha funzionato. L'app Chat non
riconosce il formato della data.
Spiega come correggere l'errore indicando all'utente il formato della data previsto
e fornisce un esempio di data che aiuta le persone a capire cosa scrivere.
Offre maggiore assistenza con un comando slash /help. Se gli utenti sono ancora bloccati,
sanno come saperne di più.
Errore non azionabile
Un utente chiede all'app Chat di programmare una riunione con
un'altra persona. L'app Chat risponde con un
messaggio di errore inutile e non risolvibile:
Enter the correct date format.
Questo messaggio di errore non è azionabile per i seguenti motivi:
Non dice se ha pianificato la riunione. L'utente potrebbe esitare a
riprogrammare la riunione o potrebbe presumere che la riunione sia stata programmata.
Non indica all'utente come formattare la data. Invece di presumere che gli utenti sappiano come formattare la data, dovrebbe essere indicato che è previsto il formato 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 di chat.
Prova
Ora che sai come scrivere errori azionabili, riesci a identificare
nel seguente scenario quale di questi errori è azionabile:
Un'app di Chat crea eventi di calendario quando gli utenti inviano un messaggio
all'app di Chat con la parola chiave schedule. Per
creare un evento nel calendario, l'app Chat richiede l'autenticazione
dell'utente. Se un utente non è stato autenticato, l'app
Chat risponde con un messaggio di errore.
Quale messaggio di errore è azionabile?
Prima di poter programmare la riunione, devi accedere digitando
/signin. Per saperne di più, digita /help.
Questo messaggio di errore è azionabile perché indica quanto segue:
Che cosa non ha funzionato. L'app Chat richiede
l'autenticazione.
Come procedere. Digita /signin per l'autenticazione.
Come ricevere assistenza. Se l'utente vuole maggiori informazioni, può digitare
/help.
Devi autenticarti.
Questo messaggio di errore non è azionabile perché non indica come
eseguire l'autenticazione.
Accedi.
Questo messaggio di errore non è utilizzabile perché non indica come accedere e implica che l'utente sia disconnesso anziché dirlo chiaramente, il che è fonte di confusione.
Impossibile programmare la riunione.
Questo messaggio di errore non è azionabile perché non indica all'utente
perché non è possibile programmare la riunione o come può procedere. Nessun aiuto
è fornito.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-08-29 UTC."],[[["\u003cp\u003eGoogle Chat app error messages should be actionable, guiding users on how to resolve issues and proceed.\u003c/p\u003e\n"],["\u003cp\u003eActionable error messages clearly explain the problem, provide steps for fixing it, and offer additional help resources.\u003c/p\u003e\n"],["\u003cp\u003eInactionable error messages are vague, lack guidance, and can lead to user frustration and abandonment.\u003c/p\u003e\n"],["\u003cp\u003eUse the actionable error message structure: state the problem, guide the user on fixing it, and offer further help (e.g., \u003ccode\u003e/help\u003c/code\u003e command).\u003c/p\u003e\n"],["\u003cp\u003eWhen writing error messages, assume users need clear instructions and avoid ambiguity.\u003c/p\u003e\n"]]],["Actionable error messages in Google Chat apps should specify what went wrong, how to fix it, and how to get further assistance. For example, an actionable message for an incorrect date format would state that the format is unrecognized, specify the required format (yyyy-mm-dd), and provide a /help command. In contrast, inactionable errors are vague, omit how to correct the issue, and offer no additional support. A sign-in error should also include clear instructions, and help commands.\n"],null,["# Write actionable error messages\n\nThis page describes best practices to write actionable error messages that tell\nthe user how to fix the issue so that they can complete their goal.\n\nWhen a user is interacting with a Google Chat app, encountering\nerror messages can be a frustrating experience when the error isn't actionable.\nFor example, the error message, `An error occurred`, isn't useful because the\nmessage doesn't explain what went wrong, how the user can fix the issue, or how\nthe user can get help. This page describes how to structure error messages so\nthat they're useful to users by showing actionable and inactionable examples.\n\nError message structure\n-----------------------\n\nAn actionable error message has the following structure:\n\n- **What went wrong.** Saying why the Chat app can't complete a request helps the user resolve the issue. Explaining why an error occurred builds trust.\n- **How the user can proceed toward their goal.** It's never enough to just say what went wrong. Tell users how they can move past the error and complete their goal.\n- **How to get help.** If the user is still stuck, tell them how they can get more help. This could be a `/help` command or a link to documentation for your Chat app.\n\nExample error message: incorrect date format\n--------------------------------------------\n\nIn this example, the user entered a date in a format that\nthe Chat app didn't expect. They wrote\n`November 19, 2021`, but the Chat app expects\n`2021-11-19`.\n\nHere's an actionable and an inactionable version of the error message that the\nChat app responds with:\n\n#### Actionable error\n\nA user asks the Chat app to schedule a meeting with\nanother person. The Chat app responds with a good,\nactionable error message:\n\n``I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.``\n\nThis error message is actionable for the following reasons:\n\n- Says what went wrong. The Chat app doesn't recognize the date format.\n- Explains how to fix the error by telling the user the expected date format and gives an example date that helps people understand what to write.\n- Offers more help with a `/help` slash command. If users are still stuck, they know how to learn more.\n\n#### Inactionable error\n\nA user asks the Chat app to schedule a meeting with\nanother person. The Chat app responds with an\nunhelpful, inactionable error message:\n\n`Enter the correct date format.`\n\nThis error message is inactionable for the following reasons:\n\n- Doesn't say whether it scheduled the meeting. The user might be hesitant to reschedule the meeting, or they might assume that the meeting was scheduled.\n- Doesn't tell the user how to format the date. Instead of assuming that users know how to format the date, it should say that it's expecting the date format `yyyy-mm-dd`.\n- Doesn't offer more help. When users are stuck and don't know how to proceed, they might stop messaging the Chat app.\n\nTry it out\n----------\n\nNow that you know how to write actionable errors, can you identify in the\nfollowing scenario which of these errors is actionable:\n\nA Chat app creates calendar events when users message\nthe Chat app with the keyword `schedule`. To\ncreate a calendar event, the Chat app requires user\nauthentication. If a user hasn't been authenticated, then the\nChat app responds with an error message. \nWhich error message is actionable? \nBefore I can schedule the meeting, you must sign in by typing `/signin`. To learn more, type `/help`. \nThis error message is actionable because it says the following:\n\n- What went wrong. The Chat app requires authentication.\n- How to proceed. Type `/signin` to authenticate.\n- How to get help. If the user wants more information, they can type `/help`. \nYou must authenticate. \nThis error message is inactionable because it doesn't say how to authenticate. \nSign in. \nThis error message is inactionable because it doesn't say how to sign in, and it implies that the user is signed out instead of clearly saying so, which is confusing. \nCan't schedule meeting. \nThis error message is inactionable because it doesn't tell the user why the meeting can't be scheduled or how the user can proceed. No help is provided."]]
