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

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

כשמשתמשים מקיימים אינטראקציה עם אפליקציה ל-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 יוצרת אירועים ביומן כשמשתמשים שולחים לאפליקציה הודעה עם מילת המפתח schedule. כדי ליצור אירוע ביומן, אפליקציית Chat דורשת אימות משתמש. אם המשתמש לא עבר אימות, אפליקציית Chat משיבה בהודעת שגיאה.