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

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

عندما يتفاعل المستخدم مع تطبيق 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 برسالة خطأ.