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

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

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