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

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

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

ما هي رسالة الخطأ التي يمكن اتّخاذ إجراء بشأنها؟

قبل أن أتمكّن من جدولة الاجتماع، عليك تسجيل الدخول عن طريق كتابة /signin. لمزيد من المعلومات، اكتب /help.

يمكن اتّخاذ إجراء بشأن رسالة الخطأ هذه لأنّها تتضمّن ما يلي:

• ما المشكلة؟ يتطلّب تطبيق Chat المصادقة.
• كيفية المتابعة اكتب /signin للمصادقة.
• كيفية الحصول على المساعدة إذا أراد المستخدم الحصول على مزيد من المعلومات، يمكنه كتابة /help.

يجب إثبات هويتك.

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

سجِّل الدخول.

رسالة الخطأ هذه غير قابلة للتنفيذ لأنّها لا توضّح كيفية تسجيل الدخول، كما أنّها تشير إلى أنّ المستخدم مسجّل الخروج بدلاً من توضيح ذلك بشكل مباشر، ما يسبّب إرباكًا.

لا يمكن تحديد موعد للاجتماع.

رسالة الخطأ هذه غير قابلة للتنفيذ لأنّها لا توضّح للمستخدم سبب عدم إمكانية جدولة الاجتماع أو كيفية المتابعة. لم يتم تقديم أي مساعدة.