קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף הזה מוסבר על שיטות מומלצות לכתיבת הודעות שגיאה שכוללות הוראות פעולה, כדי שהמשתמש יוכל לפתור את הבעיה ולהשיג את המטרה שלו.
כשמשתמשים מקיימים אינטראקציה עם אפליקציה ל-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.
צריך לבצע אימות.
אי אפשר לפעול לפי הודעת השגיאה הזו כי לא מצוין בה איך לבצע אימות.
מתחברים לחשבון.
אי אפשר לפעול לפי הודעת השגיאה הזו כי לא מצוין בה איך להתחבר, והיא מרמזת שהמשתמש לא מחובר במקום לציין זאת באופן ברור, מה שגורם לבלבול.
אי אפשר לתזמן פגישה.
אי אפשר לפעול לפי הודעת השגיאה הזו כי היא לא מציינת למשתמש למה אי אפשר לתזמן את הפגישה או איך אפשר להמשיך. אין עזרה.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-08-29 (שעון UTC)."],[[["\u003cp\u003eGoogle Chat app error messages should be actionable, guiding users on how to resolve issues and proceed.\u003c/p\u003e\n"],["\u003cp\u003eActionable error messages clearly explain the problem, provide steps for fixing it, and offer additional help resources.\u003c/p\u003e\n"],["\u003cp\u003eInactionable error messages are vague, lack guidance, and can lead to user frustration and abandonment.\u003c/p\u003e\n"],["\u003cp\u003eUse the actionable error message structure: state the problem, guide the user on fixing it, and offer further help (e.g., \u003ccode\u003e/help\u003c/code\u003e command).\u003c/p\u003e\n"],["\u003cp\u003eWhen writing error messages, assume users need clear instructions and avoid ambiguity.\u003c/p\u003e\n"]]],["Actionable error messages in Google Chat apps should specify what went wrong, how to fix it, and how to get further assistance. For example, an actionable message for an incorrect date format would state that the format is unrecognized, specify the required format (yyyy-mm-dd), and provide a /help command. In contrast, inactionable errors are vague, omit how to correct the issue, and offer no additional support. A sign-in error should also include clear instructions, and help commands.\n"],null,["# Write actionable error messages\n\nThis page describes best practices to write actionable error messages that tell\nthe user how to fix the issue so that they can complete their goal.\n\nWhen a user is interacting with a Google Chat app, encountering\nerror messages can be a frustrating experience when the error isn't actionable.\nFor example, the error message, `An error occurred`, isn't useful because the\nmessage doesn't explain what went wrong, how the user can fix the issue, or how\nthe user can get help. This page describes how to structure error messages so\nthat they're useful to users by showing actionable and inactionable examples.\n\nError message structure\n-----------------------\n\nAn actionable error message has the following structure:\n\n- **What went wrong.** Saying why the Chat app can't complete a request helps the user resolve the issue. Explaining why an error occurred builds trust.\n- **How the user can proceed toward their goal.** It's never enough to just say what went wrong. Tell users how they can move past the error and complete their goal.\n- **How to get help.** If the user is still stuck, tell them how they can get more help. This could be a `/help` command or a link to documentation for your Chat app.\n\nExample error message: incorrect date format\n--------------------------------------------\n\nIn this example, the user entered a date in a format that\nthe Chat app didn't expect. They wrote\n`November 19, 2021`, but the Chat app expects\n`2021-11-19`.\n\nHere's an actionable and an inactionable version of the error message that the\nChat app responds with:\n\n#### Actionable error\n\nA user asks the Chat app to schedule a meeting with\nanother person. The Chat app responds with a good,\nactionable error message:\n\n``I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.``\n\nThis error message is actionable for the following reasons:\n\n- Says what went wrong. The Chat app doesn't recognize the date format.\n- Explains how to fix the error by telling the user the expected date format and gives an example date that helps people understand what to write.\n- Offers more help with a `/help` slash command. If users are still stuck, they know how to learn more.\n\n#### Inactionable error\n\nA user asks the Chat app to schedule a meeting with\nanother person. The Chat app responds with an\nunhelpful, inactionable error message:\n\n`Enter the correct date format.`\n\nThis error message is inactionable for the following reasons:\n\n- Doesn't say whether it scheduled the meeting. The user might be hesitant to reschedule the meeting, or they might assume that the meeting was scheduled.\n- Doesn't tell the user how to format the date. Instead of assuming that users know how to format the date, it should say that it's expecting the date format `yyyy-mm-dd`.\n- Doesn't offer more help. When users are stuck and don't know how to proceed, they might stop messaging the Chat app.\n\nTry it out\n----------\n\nNow that you know how to write actionable errors, can you identify in the\nfollowing scenario which of these errors is actionable:\n\nA Chat app creates calendar events when users message\nthe Chat app with the keyword `schedule`. To\ncreate a calendar event, the Chat app requires user\nauthentication. If a user hasn't been authenticated, then the\nChat app responds with an error message. \nWhich error message is actionable? \nBefore I can schedule the meeting, you must sign in by typing `/signin`. To learn more, type `/help`. \nThis error message is actionable because it says the following:\n\n- What went wrong. The Chat app requires authentication.\n- How to proceed. Type `/signin` to authenticate.\n- How to get help. If the user wants more information, they can type `/help`. \nYou must authenticate. \nThis error message is inactionable because it doesn't say how to authenticate. \nSign in. \nThis error message is inactionable because it doesn't say how to sign in, and it implies that the user is signed out instead of clearly saying so, which is confusing. \nCan't schedule meeting. \nThis error message is inactionable because it doesn't tell the user why the meeting can't be scheduled or how the user can proceed. No help is provided."]]
