كتابة رسائل خطأ قابلة للتنفيذ

توضّح هذه الصفحة أفضل الممارسات لكتابة رسائل خطأ قابلة للتنفيذ تُعلم المستخدم بكيفية حلّ المشكلة حتى يتمكّن من إكمال هدفه.

عندما يتفاعل مستخدم مع تطبيق 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 أحداث التقويم عندما يرسل المستخدمون رسائل إلى تطبيق Chat باستخدام الكلمة الرئيسية schedule. ل إنشاء حدث تقويم، يتطلب تطبيق Chat مصادقة المستخدم. إذا لم تتم مصادقة المستخدم، سيعرض تطبيق Chat رسالة خطأ.