כתיבת הודעות שגיאה שימושיות

בדף הזה מתוארות שיטות מומלצות לכתיבת הודעות שגיאה פרקטיות שמסבירות למשתמשים איך לתקן את הבעיה, כדי שהם יוכלו להשלים את היעד.

כשמשתמש מנהל אינטראקציה עם אפליקציית Google Chat, הודעות שגיאה יכולות להיות חוויה מתסכלת שאי אפשר לטפל בה. לדוגמה, הודעת השגיאה An error occurred לא מועילה כי ההודעה לא מסבירה מה השתבש, איך המשתמש יכול לפתור את הבעיה או איך המשתמש יכול לקבל עזרה. בדף הזה נסביר איך לבנות הודעות שגיאה כך שהן יועילו למשתמשים, באמצעות הצגת דוגמאות לפעולות שלא ניתן לבצע.

מבנה הודעת השגיאה

הודעת שגיאה עם אפשרות פעולה בנויה באופן הבא:

  • מה השתבש. כשאתם מסבירים למה אפליקציית Chat לא יכולה להשלים בקשה, המשתמש יכול לפתור את הבעיה. להסביר מדוע שגיאה אירעה כדי לבנות אמון.
  • איך המשתמשים יכולים להתקדם לעבר היעד. אף פעם לא מספיק לומר מה השתבש. ספרו למשתמשים איך הם יכולים להתגבר על הטעות ולהשלים את היעד שלהם.
  • איך אפשר לקבל עזרה? אם המשתמש עדיין תקוע, ספרו לו איך הוא יכול לקבל עזרה נוספת. זו יכולה להיות פקודת /help או קישור למסמכי תיעוד של אפליקציית Chat.

הודעת שגיאה לדוגמה: פורמט תאריך שגוי

בדוגמה הזו, המשתמש הזין תאריך בפורמט שלא היה צפוי באפליקציית Chat. הם כתבו November 19, 2021, אבל אפליקציית Chat מצפה ל-2021-11-19.

לפניכם גרסה של הודעת השגיאה שאפליקציית Chat מגיבה למשתמשים ושאי אפשר לטפל בה:

שגיאה שאפשר לפעול לפיה

משתמש מבקש מאפליקציית Chat לקבוע פגישה עם מישהו אחר. אפליקציית Chat מגיבה עם הודעת שגיאה טובה וניתנת לפעולה:

I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.

הודעת שגיאה לדוגמה שמסבירה למשתמש מה השתבש, איך להמשיך ואיך לקבל עזרה.

הודעת השגיאה הזו ניתנת לפעולה מהסיבות הבאות:

  • אומר מה השתבש. אפליקציית Chat לא מזהה את פורמט התאריך.
  • הסבר למשתמשים איך לתקן את השגיאה באמצעות פורמט התאריך הצפוי, יחד עם תאריך לדוגמה שעוזר לאנשים להבין מה לכתוב.
  • קבלת עזרה נוספת באמצעות פקודת הלוכסן /help. אם המשתמשים עדיין תקועים, הם יודעים איך לקבל מידע נוסף.

שגיאה שלא ניתנת לפעולה

משתמש מבקש מאפליקציית Chat לקבוע פגישה עם מישהו אחר. אפליקציית Chat מגיבה להודעה עם הודעת שגיאה לא מועילה שלא מאפשרת:

Enter the correct date format.

דוגמה להודעת שגיאה שלא מספקת מידע פרקטי.

הודעת השגיאה הזו לא ניתנת לביצוע מהסיבות הבאות:

  • לא מצוין אם הפגישה נקבעה. המשתמש יכול להיות מהסס לקבוע מחדש את הפגישה או להניח שהפגישה נקבעה.
  • המשתמש לא מסביר למשתמש איך לעצב את התאריך. במקום להניח שהמשתמשים יודעים איך לעצב את התאריך, צריך לציין שהוא מצפה לפורמט התאריך yyyy-mm-dd.
  • אינו מציע עזרה נוספת. כשמשתמשים נתקעים ולא יודעים איך להמשיך, יכול להיות שהם יפסיקו לשלוח הודעות לאפליקציית Chat.

אני רוצה לנסות

עכשיו, אחרי שלמדתם איך לכתוב שגיאות פרקטיות, תוכלו לזהות בתרחיש הבא איזו מהשגיאות הבאות אפשר לבצע:

אפליקציית Chat יוצרת אירועים ביומן כשמשתמשים שולחים הודעה לאפליקציית Chat באמצעות מילת המפתח schedule. כדי ליצור אירוע ביומן, צריך לאמת את המשתמשים באפליקציית Chat. אם המשתמש לא אומת, הודעת השגיאה תופיע באפליקציית Chat.

איזו הודעת שגיאה אפשר לבצע?
כדי לקבוע את הפגישה, צריך להיכנס לחשבון באמצעות הקלדת /signin. למידע נוסף, יש להקליד /help.
הודעת השגיאה הזו מיועדת לפעולה כי כתוב בה:
  • מה השתבש? צריך לאמת את אפליקציית Chat.
  • איך להמשיך. יש להקליד /signin כדי לאמת.
  • איך אפשר לקבל עזרה? אם המשתמש רוצה מידע נוסף, הוא יכול להקליד /help.
חובה לבצע אימות.
לא ניתן לבצע פעולה בהודעת השגיאה הזו כי לא מוסבר בה איך לבצע אימות.
מתחברים לחשבון.
לא ניתן לנקוט פעולה לגבי הודעת השגיאה הזו כי לא כתוב בה איך להיכנס לחשבון, ומשתמע שהמשתמש יצא מהחשבון, במקום לומר זאת בבירור, דבר מבלבל.
אי אפשר לקבוע את הפגישה.
אי אפשר לבצע פעולה בהודעת השגיאה הזו כי היא לא מבהירה למשתמש למה אי אפשר לקבוע את הפגישה, או איך הוא יכול להמשיך. לא ניתן לקבל עזרה.