Rédiger des messages d'erreur exploitables

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 rencontre messages d'erreur peuvent être une expérience frustrante lorsque l'erreur n'est pas exploitable. Par exemple, le message d'erreur An error occurred n'est pas utile, car le n'explique pas ce qui s'est mal passé, comment l'utilisateur peut le résoudre ou comment l'utilisateur peut obtenir de l'aide. Cette page explique comment structurer les messages d'erreur pour qu'elles sont utiles aux utilisateurs en montrant des exemples exploitables et non exploitables.

Structure du message d'erreur

Un message d'erreur exploitable se présente comme suit:

  • Que s'est-il passé ? Expliquer pourquoi l'application Chat ne peut pas être utilisée terminer une demande aide l'utilisateur à résoudre le problème. Expliquer pourquoi une erreur établit une relation de confiance.
  • Comment l'utilisateur peut-il atteindre son objectif ? Il ne suffit jamais disons ce qui s’est mal passé. Indiquez aux utilisateurs comment ils peuvent passer outre l'erreur et terminer leur objectif.
  • Comment obtenir de l'aide ? Si l'utilisateur est toujours bloqué, dites-lui comment il peut plus d'aide. Il peut s'agir d'une commande /help ou d'un lien vers la documentation votre application Chat.

Exemple de message d'erreur: format de date incorrect

Dans cet exemple, l'utilisateur a saisi une date dans un format qui que l'application Chat ne s'y attendait pas. Ils ont écrit November 19, 2021, mais l'application Chat attend 2021-11-19

Voici une version concrète et une version non concrète du message d'erreur L'application Chat répond avec:

Erreur actionnable

Un utilisateur demande à l'application Chat de planifier une réunion avec une autre personne. L'application Chat renvoie un message message d'erreur 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`.

Exemple de message d'erreur indiquant à l'utilisateur ce qui s'est mal passé, comment procéder et comment obtenir de l'aide.

Vous pouvez utiliser ce message d'erreur pour les raisons suivantes:

  • Dit ce qui s'est mal passé. L'application Chat ne fait pas reconnaître le format de la date.
  • Explique comment corriger l'erreur en indiquant à l'utilisateur le format de date attendu et donne un exemple de date qui aide les gens à comprendre ce qu'il faut é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 inaction

Un utilisateur demande à l'application Chat de planifier une réunion avec une autre personne. L'application Chat renvoie un message message d'erreur inutile, non applicable:

Enter the correct date format.

Exemple de message d'erreur ne fournissant pas d'informations exploitables.

Ce message d'erreur ne peut pas être utilisé pour les raisons suivantes:

  • Il n'indique pas si la réunion a été planifiée. L'utilisateur peut hésiter à reprogrammer la réunion, ou il peut supposer que la réunion a été programmée.
  • N'indique pas à l'utilisateur comment mettre en forme la date. Au lieu de supposer que les utilisateurs savent formater la date, il doit indiquer qu'il s'attend à ce que format de date yyyy-mm-dd.
  • Il ne propose pas d'aide supplémentaire. Lorsque les utilisateurs sont bloqués et ne savent pas comment procéder, il pourrait arrêter de envoyer des messages à l'application Chat.

Essayer

Maintenant que vous savez comment écrire des erreurs exploitables, pouvez-vous identifier dans les scénario suivant, laquelle de ces erreurs est exploitable:

Une application Chat crée des événements d'agenda lorsque les utilisateurs envoient des messages l'application Chat avec le mot clé schedule ; À créer un événement d'agenda, l'application Chat exige que les utilisateurs l'authentification unique. Si un utilisateur n'a pas été authentifié, L'application de chat renvoie un message d'erreur.

Quel message d'erreur peut être traité ?
Pour que je puisse planifier la réunion, vous devez vous connecter en saisissant du texte /signin Pour en savoir plus, saisissez /help.
Vous pouvez agir sur ce message d'erreur, car il indique ce qui suit: <ph type="x-smartling-placeholder">
    </ph>
  • Que s'est-il passé ? L'application Chat requiert l'authentification unique.
  • Procédure à suivre Saisissez /signin pour vous authentifier.
  • Comment obtenir de l'aide Si l'utilisateur veut plus d'informations, il peut saisir /help
Vous devez vous authentifier.
Ce message d'erreur est inactionnable, car il n'indique pas comment s'authentifier.
Connectez-vous.
Ce message d'erreur est inactionnable, car il n'indique pas comment signer et cela implique que l'utilisateur est déconnecté au lieu de dire clairement ce qui est déroutant.
Impossible de planifier la réunion.
Ce message d'erreur est inactionnable, car il n'indique pas à l'utilisateur pourquoi la réunion ne peut pas être planifiée ou comment l'utilisateur peut continuer. Pas d'aide est fournie.