رفتن به محتوای اصلی

نوشتن پیام خطا به فارسی؛ الگو و نمونه برای هر موقعیت

پیام خطای خوب می‌گوید چه شد و حالا چه کنیم، بدون مقصر دانستن کاربر. یک الگوی ساده، نمونه برای فرم، پرداخت، اتصال و دسترسی، و اشتباه‌هایی که بیشتر از همه تکرار می‌شوند.

کاور مقاله: نوشتن پیام خطا به فارسی

پیام خطا جایی است که کاربر گیر کرده، احتمالاً عجله دارد و شاید کمی هم عصبانی است. این بدترین لحظه برای جمله‌ی مبهم است، و دقیقاً همان‌جایی است که بیشتر محصول‌ها «خطایی رخ داده است» می‌نویسند.

خبر خوب: پیام خطای خوب یک الگوی ساده دارد که تقریباً همه‌جا جواب می‌دهد.

الگو: چه شد + حالا چه

پیام خطا دو بخش دارد:

  1. چه شد: یک جمله‌ی کوتاه که مشکل را به زبان کاربر می‌گوید.
  2. حالا چه: کاری که کاربر می‌تواند انجام دهد.

«اتصال قطع شد. دوباره امتحان کنید.» «این ایمیل قبلاً ثبت شده است. وارد شوید یا رمز را بازیابی کنید.»

اگر کد فنی برای پشتیبانی لازم است، در خط دوم و کم‌رنگ بیاید: «کد پیگیری ۴۰۴۱۲». هیچ‌وقت در جمله‌ی اصلی.

الگوی پیام خطا: چه شد و حالا چه، با کد پیگیری در خط دوم
اول مشکل به زبان کاربر، بعد قدم بعدی؛ کد فنی فقط در خط دوم

نمونه برای هر موقعیت

فرم:

مبهمروشن
ورودی نامعتبر استشماره‌ی موبایل باید ۱۱ رقم باشد و با ۰۹ شروع شود.
فیلد اجبارینام را بنویسید.
فرمت ایمیل اشتباه استایمیل باید @ داشته باشد، مثل name@example.com

پرداخت:

مبهمروشن
تراکنش ناموفقپرداخت انجام نشد و مبلغی از حسابتان کم نشد. دوباره امتحان کنید.
خطای درگاهدرگاه بانک پاسخ نداد. اگر مبلغی کم شده، تا ۷۲ ساعت برمی‌گردد.

اتصال و سرور:

مبهمروشن
Network Errorاتصال اینترنت قطع است. وقتی وصل شدید، دوباره امتحان کنید.
خطای سرورمشکلی در سرور ما پیش آمد. چند دقیقه‌ی دیگر دوباره امتحان کنید.

دسترسی:

مبهمروشن
دسترسی غیرمجازبرای دیدن این صفحه باید وارد شوید.
۴۰۳این بخش فقط برای مدیران است. اگر فکر می‌کنید باید دسترسی داشته باشید، به مدیر تیم بگویید.

پنج اشتباه پرتکرار

پنج اشتباه رایج در پیام خطا و جایگزین درست هرکدام
مقصر دانستن، علامت تعجب، اصطلاح فنی، پاک کردن فرم و جای اشتباه
  1. مقصر دانستن کاربر. «شما رمز را اشتباه وارد کردید» ← «ایمیل یا رمز عبور درست نیست.» خطا درباره‌ی وضعیت است، نه آدم.
  2. علامت تعجب. «خطا!» لحن را از راهنما به سرزنش تبدیل می‌کند.
  3. اصطلاح فنی. «Timeout»، «۵۰۰» و «Exception» برای کاربر معنا ندارند.
  4. پاک کردن فرم. پیام خطا هرچقدر هم خوب باشد، اگر فرم خالی شده باشد، کاربر می‌رود.
  5. جای اشتباه. خطای یک فیلد کنار همان فیلد می‌آید، نه بالای صفحه.

امنیت و پیام خطا

یک استثنا: در ورود، نگویید کدام بخش اشتباه است. «ایمیل یا رمز عبور درست نیست» بهتر از «این ایمیل ثبت نشده» است، چون دومی به کسی که حساب‌ها را حدس می‌زند می‌گوید کدام ایمیل‌ها وجود دارند.

لحن

خطا جای شوخی نیست، ولی جای جمله‌ی سرد اداری هم نیست. «می‌باشد» و «مبذول فرمایید» را کنار بگذارید و مثل یک آدم آرام و کمک‌کننده بنویسید. قاعده‌های بیشتر لحن را در ۱۲ قاعده‌ی یوایکس رایتینگ فارسی آورده‌ام.

عکس سپنتا پویا
نویسنده

طراح محصول و سازنده‌ی دیزاین‌سیستم کاشی. سایت‌های زیادی را با هوش مصنوعی ساخته‌ام و چند سال اخیر روی ایجنتیک کردن فرایندهای هوش مصنوعی کار کرده‌ام. اسکیل‌های این سایت همان‌هایی‌اند که خودم هر روز با آن‌ها کار می‌کنم.

بیشتر درباره‌ی من

چیزی که خواندید را همین امروز به دستیارتان بدهید

همه‌ی این اسکیل‌ها با لایسنس دائمی، به‌روزرسانی رایگان برای همیشه و راهنمای نصب برای همه‌ی ابزارها.

تایید شده توسط سپنتا پویا
محتوا · v1.0.0

یوایکس رایتر فارسی

متن رابط سایت و اپ شما را بازنویسی می‌کند یا از صفر می‌نویسد: دکمه، خطا، حالت خالی، اعلان، لحن برند و درست‌نویسی.

Claude CodeClaude.aiCodexCursorGemini CLI
۵۹۰٬۰۰۰ تومان۸۹۰٬۰۰۰