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

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

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