Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page décrit les bonnes pratiques à suivre pour rédiger des messages d'erreur exploitables qui indiquent à l'utilisateur comment résoudre le problème afin qu'il puisse atteindre son objectif.
Lorsqu'un utilisateur interagit avec une application Google Chat, il peut être frustrant de rencontrer des messages d'erreur qui ne sont pas exploitables.
Par exemple, le message d'erreur An error occurred n'est pas utile, car il n'explique pas ce qui s'est mal passé, comment l'utilisateur peut résoudre le problème ni comment il peut obtenir de l'aide. Cette page explique comment structurer les messages d'erreur pour qu'ils soient utiles aux utilisateurs. Elle présente des exemples d'actions à effectuer et à ne pas effectuer.
Structure des messages d'erreur
Un message d'erreur exploitable a la structure suivante :
Quel problème avez-vous rencontré ? Expliquer pourquoi l'application de chat ne peut pas traiter une demande aide l'utilisateur à résoudre le problème. Expliquer pourquoi une erreur s'est produite renforce la confiance.
Comment l'utilisateur peut atteindre son objectif. Il ne suffit jamais de simplement dire ce qui n'a pas fonctionné. Indiquez aux utilisateurs comment surmonter l'erreur et atteindre leur objectif.
Obtenir de l'aide Si l'utilisateur est toujours bloqué, expliquez-lui comment obtenir de l'aide. Il peut s'agir d'une commande /help ou d'un lien vers la documentation de votre application Chat.
Exemple de message d'erreur : format de date incorrect
Dans cet exemple, l'utilisateur a saisi une date dans un format non reconnu par l'application Chat. Il a écrit November 19, 2021, mais l'application Chat attend 2021-11-19.
Voici une version exploitable et une version non exploitable du message d'erreur renvoyé par l'application Chat :
Erreur exploitable
Un utilisateur demande à l'application Chat de programmer une réunion avec une autre personne. L'application Chat répond avec un message d'erreur clair et exploitable :
I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.
Ce message d'erreur est exploitable pour les raisons suivantes :
Indique le problème rencontré. L'application Chat ne reconnaît pas le format de date.
Explique comment corriger l'erreur en indiquant à l'utilisateur le format de date attendu et en lui donnant un exemple de date pour l'aider à comprendre ce qu'il doit écrire.
Offre plus d'aide avec une commande à barre oblique /help. Si les utilisateurs sont toujours bloqués, ils savent comment en savoir plus.
Erreur non exploitable
Un utilisateur demande à l'application Chat de programmer une réunion avec une autre personne. L'application Chat renvoie un message d'erreur inutile et inapplicable :
Enter the correct date format.
Ce message d'erreur ne nécessite aucune action pour les raisons suivantes :
Ne précise pas si la réunion a été programmée. L'utilisateur peut hésiter à reprogrammer la réunion ou supposer qu'elle a été planifiée.
N'indique pas à l'utilisateur comment mettre en forme la date. Au lieu de supposer que les utilisateurs savent comment mettre en forme la date, il devrait indiquer qu'il attend la date au format yyyy-mm-dd.
Ne propose pas d'aide supplémentaire. Lorsque les utilisateurs sont bloqués et ne savent pas comment procéder, ils peuvent cesser d'envoyer des messages à l'application Chat.
Essayer
Maintenant que vous savez comment rédiger des messages d'erreur exploitables, pouvez-vous identifier celui qui l'est dans le scénario suivant ?
Une application Chat crée des événements d'agenda lorsque les utilisateurs envoient un message à l'application Chat avec le mot clé schedule. Pour créer un événement d'agenda, l'application Chat nécessite l'authentification de l'utilisateur. Si un utilisateur n'a pas été authentifié, l'application Chat répond par un message d'erreur.
Quel message d'erreur est exploitable ?
Avant que je puisse planifier la réunion, vous devez vous connecter en saisissant /signin. Pour en savoir plus, saisissez /help.
Ce message d'erreur est exploitable, car il indique ce qui suit :
Ce qui n'a pas fonctionné. L'application Chat nécessite une authentification.
Comment procéder ? Saisissez /signin pour vous authentifier.
Obtenir de l'aide Si l'utilisateur souhaite obtenir plus d'informations, il peut saisir /help.
Vous devez vous authentifier.
Ce message d'erreur est inutilisable, car il n'indique pas comment s'authentifier.
Connectez-vous.
Ce message d'erreur est inutilisable, car il n'indique pas comment se connecter. De plus, il sous-entend que l'utilisateur est déconnecté au lieu de le dire clairement, ce qui est déroutant.
Impossible de programmer une réunion.
Ce message d'erreur est inutilisable, car il n'indique pas à l'utilisateur pourquoi la réunion ne peut pas être programmée ni comment il peut procéder. Aucune aide n'est fournie.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]
