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`.
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.
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.
/signin
Pour en savoir plus, saisissez /help
.- </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