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

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

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

איזו הודעת שגיאה מצביעה על פעולה שצריך לבצע?

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

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

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

צריך לבצע אימות.

אי אפשר לפעול לפי הודעת השגיאה הזו כי לא מצוין בה איך לבצע אימות.

מתחברים לחשבון.

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

אי אפשר לתזמן פגישה.

אי אפשר לפעול לפי הודעת השגיאה הזו כי היא לא מציינת למשתמש למה אי אפשר לתזמן את הפגישה או איך אפשר להמשיך. אין עזרה.