ارسال کد تأیید پیامکی از سایت؛ از انتخاب خط تا گزارش تحویل

ارسال کد تأیید پیامکی از سایت چهار تصمیم دارد: از کدام خط بفرستید، متن چه باشد، کد چند دقیقه اعتبار داشته باشد و اگر پیامک نرسید چه اتفاقی بیفتد. این چهار تصمیم تقریباً همه‌ی شکایت‌های «کد نمی‌رسد» را تعیین می‌کنند. این صفحه راهنمای عملی است، نه توضیح مفهومی؛ مفهوم کد یک‌بارمصرف را در جای دیگر می‌خوانید و عیب‌یابی سمت کاربر را در صفحه‌ی دیگری. این‌جا فقط می‌خواهیم هر تصمیم را با یک قاعده‌ی روشن ببندیم.

بروزرسانی: زمان مطالعه حدود ۱۲ دقیقه نوشته‌ی تیم فنی فینگت

ارسال کد تأیید پیامکی؛ مسیر یک کد از سایت تا گوشی

برای ارسال کد تأیید پیامکی، سرور سایت شما یک کد می‌سازد، آن را همراه زمان انقضا ذخیره می‌کند، متن پیامک را از روی قالب پر می‌کند و درخواست ارسال را به یک سرویس پیامک می‌دهد. سرویس پیامک پیام را به اپراتور می‌رساند و اپراتور به گوشی. کاربر کد را در صفحه وارد می‌کند و سرور آن را با نسخه‌ی ذخیره‌شده می‌سنجد.

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

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

چه چیزی دست شماست؟

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

چه چیزی دست شما نیست؟

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

قاعده‌ی کلی: همه‌ی چیزهایی را که دست شماست درست کنید و برای چیزهایی که دست شما نیست، گزارش و راه جایگزین بگذارید.

انتخاب خط ارسال کد تأیید؛ خدماتی، تبلیغاتی یا اختصاصی؟

اولین تصمیم و مهم‌ترین آن، خط است. کد تأیید پیام خدماتی است؛ کاربر آن را خودش درخواست کرده و منتظرش است. بنابراین باید از خطی برود که برای پیام‌های خدماتی ساخته شده است. جزئیات انواع خط در انواع خط پیامک و خط خدماتی آمده؛ این‌جا فقط خلاصه‌ی تصمیم را می‌بینید.

نوع خطبرای کد تأیید مناسب است؟نکته‌ی تصمیم
خط خدماتیبله، انتخاب معمولبرای پیام‌های درخواستی مثل کد تأیید و وضعیت سفارش ساخته شده است.
خط تبلیغاتیخیرخط تبلیغاتی با قواعد لغو و فهرست مسدودی همراه است و ممکن است پیام شما دیر برسد یا نرسد.
خط اختصاصی با شماره‌ی کوتاهاگر حجم و نیاز داریدشماره‌ی شناخته‌شده‌تر می‌دهد، ولی راه‌اندازی و هزینه‌ی ثابت بیشتری دارد.
خط مشترک عمومیفقط برای شروع و آزمونممکن است پیام شما با پیام‌های دیگران در یک صف باشد و تأخیر بیشتری بگیرد.

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

متن پیامک کد تأیید؛ چه چیزی بنویسیم و چه چیزی ننویسیم؟

یک متن پیامک کد تأیید خوب، که ارسال کد تأیید پیامکی را قابل اعتماد می‌کند، کوتاه است و در نگاه اول سه چیز را نشان می‌دهد: از طرف چه کسی است، کد چیست و تا کی اعتبار دارد. نیازی به تعارف، شعار یا توضیح اضافه نیست. کاربر معمولاً فقط اعلان گوشی را یک لحظه می‌بیند.

یک قالب ساده

  • نام سایت یا برند، در ابتدا؛ تا کاربر بداند پیام برای چه کاری است.
  • کد، واضح و جدا از بقیه‌ی متن، ترجیحاً با ارقام لاتین.
  • مدت اعتبار؛ مثلاً «تا ۳ دقیقه معتبر است».
  • یک هشدار کوتاه: «کد را به هیچ‌کس ندهید.»

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

  • لینک؛ پیام‌های دارای لینک بیشتر با فیلتر مواجه می‌شوند و کاربر را هم به فیشینگ حساس می‌کنند.
  • تبلیغ یا پیشنهاد تخفیف؛ کد تأیید باید فقط کد تأیید باشد.
  • متن بلند؛ پیام طولانی به چند بخش شکسته می‌شود و ممکن است هزینه‌ی بیشتری داشته باشد.
  • چند کد در یک پیام؛ کاربر گیج می‌شود که کدام را وارد کند.

یک نکته‌ی تجربه‌ی کاربری: بعضی مرورگرهای اندروید می‌توانند کد را خودکار از پیام بخوانند، اگر آخرین خط پیام در قالب مشخصی بنویسد که نام دامنه و کد را دارد (به این قابلیت WebOTP می‌گویند). پشتیبانی آن بسته به مرورگر و پنل پیامک فرق می‌کند؛ پیش از تکیه بر آن، با چند گوشی واقعی امتحانش کنید.

نمونه‌ی متن: «فروشگاه نمونه — کد ورود شما: 482915. تا ۳ دقیقه معتبر است. آن را به کسی ندهید.»

زمان انقضای کد تأیید و سقف تلاش؛ چه عددی انتخاب کنیم؟

برای زمان انقضای کد تأیید معمولاً دو تا پنج دقیقه مناسب است. کمتر از دو دقیقه کاربری را که پیامک دیر گرفته ناامید می‌کند؛ بیشتر از پنج دقیقه فرصت حدس زدن و سوءاستفاده را بزرگ می‌کند. این عدد مقدس نیست؛ آن را با آمار «کد رسید ولی منقضی شده بود» از لاگ‌های خودتان تنظیم کنید.

انقضا تنها نیست. سه قاعده‌ی دیگر هم باید کنارش باشد: کد فقط یک بار پذیرفته شود، تعداد تلاش برای وارد کردن کد محدود باشد (مثلاً سه تا پنج بار) و بعد از آن مجبور شوند کد تازه بگیرند. بدون سقف تلاش، یک کد چهار یا پنج رقمی را می‌شود با آزمون و خطا باز کرد. توضیح بیشتر در امنیت رمز یکبار مصرف آمده است.

مثال: اگر پیامک در حالت عادی ده تا سی ثانیه می‌رسد، اما در ساعت‌های شلوغ تا دو دقیقه طول می‌کشد، انقضای سه دقیقه‌ای هنوز جا می‌دهد، ولی یک دقیقه کاربران زیادی را می‌سوزاند. پس انقضا را بر اساس کندترین حالت معمول بگذارید، نه بهترین حالت.

طول کد

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

قانون ارسال مجدد کد تأیید؛ دکمه‌ی «ارسال دوباره» کی فعال شود؟

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

  1. شمارش معکوس روی صفحه

    بعد از ارسال، یک شمارنده‌ی ۶۰ تا ۹۰ ثانیه‌ای نشان دهید و در همین مدت دکمه‌ی ارسال مجدد را غیرفعال نگه دارید. کاربر می‌داند چه مدت صبر کند.

  2. کد قبلی را باطل کنید

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

  3. فاصله‌ی ارسال‌ها را بیشتر کنید

    برای دومین و سومین ارسال مجدد فاصله را بیشتر کنید تا الگوی پشت‌سرهم از بین برود.

  4. سقف ارسال برای هر شماره

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

  5. پیام روشن به کاربر

    وقتی سقف پر شد، بنویسید چقدر باید صبر کند. «خطا رخ داد» بدترین پیام ممکن است.

همین قواعد هزینه‌ی پیامک را هم کنترل می‌کنند، چون ارسال‌های تکراری بخش بزرگی از خرج کد تأیید را می‌سازند. راه‌های دیگر کم کردن این هزینه در کم کردن هزینه‌ی OTP جمع شده است.

گزارش تحویل پیامک؛ از کجا بفهمیم کد به گوشی رسیده است؟

گزارش تحویل پیامک پیامی است که سرویس پیامک به سایت شما می‌دهد و می‌گوید پیام در چه مرحله‌ای است. معمولاً چند وضعیت دارد: در صف، به اپراتور تحویل شد، به گوشی رسید یا شکست خورد. اسم‌ها و جزئیات از پنلی به پنل دیگر فرق دارند؛ مستندات سرویس خودتان را بخوانید و فرض نکنید همه یک‌جور کار می‌کنند.

این گزارش را چطور استفاده کنیم؟

  • وضعیت هر ارسال را کنار ثبت درخواست ذخیره کنید: شماره، زمان، وضعیت و پیام خطا.
  • اگر وضعیت «شکست خورد» بود، کاربر را بی‌خبر نگذارید و همان‌جا راه جایگزین نشان دهید.
  • میزان شکست را به‌صورت روزانه نگاه کنید. افزایش ناگهانی معمولاً یعنی مشکل از خط یا اپراتور است، نه از کاربر.
  • نرخ شکست را برای هر اپراتور جدا ببینید؛ اگر فقط یکی مشکل دارد، دلیلش فرق می‌کند.

در عمل، هر بار که کاربر «ارسال دوباره» را می‌زند، یک رکورد تازه‌ی گزارش ساخته می‌شود. با مقایسه‌ی این رکوردها می‌بینید کاربری که چهار بار درخواست داده، چه وضعیت‌هایی گرفته و آیا مشکل از خود شماره است یا از شبکه‌ی پیامک.

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

راه‌های جایگزین وقتی ارسال پیامک کد تأیید جواب نمی‌دهد

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

ارسال مجدد با فاصله

همان راهی که بالا گفتیم؛ ساده‌ترین جایگزین برای کاربری که دیر پیام گرفته است.

تماس صوتی با کد

بعضی سرویس‌ها کد را با تماس تلفنی می‌خوانند. برای کاربری که پیامک نمی‌گیرد مفید است، اما هزینه و پیچیدگی بیشتری دارد.

تغییر شماره

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

ورود با روش دیگر

کاربری که کد نمی‌گیرد باید بتواند با رمز یا روش دیگری وارد شود. برای نمونه ورود با فینگت، پیامکی نمی‌فرستد.

نمایش دلیل محتمل

اگر گزارش تحویل شکست را نشان داد، به‌جای پیام کلی بگویید «پیامک به این شماره تحویل نشد؛ شماره را بررسی کنید یا روش دیگری امتحان کنید».

پشتیبانی انسانی

یک راه تماس واضح: اگر همه‌ی راه‌ها شکست خورد، کاربر بتواند به یک نفر برسد.

اشتباه‌هایی که ارسال پیامک کد تأیید را خراب می‌کند

ارسال کد با خط تبلیغاتی

کد تأیید با خط تبلیغاتی ممکن است دیر برسد یا فیلتر شود. برای پیام درخواستی از خط خدماتی استفاده کنید.

ثبت نکردن گزارش تحویل

اگر وضعیت ارسال‌ها را ذخیره نکنید، وقتی کاربری می‌گوید کد نرسیده نمی‌توانید بفهمید کجا گیر کرده است.

کد قدیمی هنوز معتبر

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

ارسال از سمت مرورگر

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

ارسال بدون سقف

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

فرض اینکه همه پیامک می‌گیرند

اگر ارسال کد تأیید پیامکی تنها راه ورود باشد، مسافر خارج از کشور، سیم‌کارت بدون آنتن و گوشی دوسیم‌کارته از این دسته‌اند.

ساخت و ارسال کد در سرور؛ منطق کوتاه با توضیح فارسی

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

منطق ساخت، ارسال و بررسی کد (شبه‌کد جاوااسکریپت)
// ساخت کد شش‌رقمی تصادفی با تولیدکننده‌ی امن
const code = String(crypto.randomInt(0, 1_000_000)).padStart(6, '0')

// فقط نسخه‌ی درهم‌شده‌ی کد را با زمان انقضا ذخیره کنید
await store.save(phone, { hash: sha256(code), expiresAt: Date.now() + 3 * 60 * 1000, tries: 0 })

// قالب پیام: نام سایت، کد، مدت اعتبار و هشدار
const text = `فروشگاه نمونه — کد ورود شما: ${code}\nتا ۳ دقیقه معتبر است. آن را به کسی ندهید.`

// تابع ارسال را با پنل پیامک خودتان جایگزین کنید؛ نتیجه را برای گزارش تحویل ذخیره کنید
const result = await sendSms(phone, text)
await log.save({ phone, status: result.status, at: Date.now() })

// بررسی کد: انقضا، سقف تلاش و یک‌بارمصرف بودن
function check(phone, input) {
  const rec = store.get(phone)
  if (!rec || Date.now() > rec.expiresAt || rec.tries >= 5) return false
  rec.tries++
  if (sha256(input) !== rec.hash) return false
  store.delete(phone) // کد بعد از یک بار استفاده باطل می‌شود
  return true
}

سناریوی نمونه؛ فروشگاهی که ارسال کد را بازبینی کرد

سناریوی نمونه

فروشگاه لوازم ورزشی

فرض کنید فروشگاهی کد ورود را با یک خط تبلیغاتی می‌فرستد و بعضی مشتریان می‌گویند کد دیر می‌رسد. صاحب فروشگاه سه چیز را عوض می‌کند: خط را به خط خدماتی می‌برد، متن را کوتاه می‌کند و لینک را برمی‌دارد و یک شمارنده‌ی ارسال مجدد با سقف ساعتی می‌گذارد. همچنین وضعیت هر ارسال را ذخیره می‌کند. بعد از مدتی در گزارش‌ها می‌بیند بیشتر شکست‌ها مربوط به یک اپراتور است و برای همان‌ها یک راه ورود جایگزین نشان می‌دهد. نتیجه‌ی منطقی این است که شکایت کمتر می‌شود و هزینه‌ی ارسال‌های تکراری پایین می‌آید.

کم کردن نیاز به ارسال پیامک کد تأیید با فینگت

هر راهی که بتواند تعداد پیامک‌ها را کم کند، هم هزینه را پایین می‌آورد و هم یک حلقه‌ی خراب‌شدنی را از زنجیره برمی‌دارد. در «ورود با فینگت»، کاربر شماره‌اش را یک بار هنگام ثبت‌نام در اپ تایید می‌کند و بعد برای ورود به سایت‌های متصل فقط یک تأیید روی گوشی می‌زند. سایت شما برای ورود چنین کاربری پیامکی نمی‌فرستد و شماره‌ی تاییدشده را همراه نام و یک شناسه‌ی ثابت می‌گیرد.

پس فینگت جای سرویس پیامک شما را نمی‌گیرد؛ پنل پیامک نیست و پیامک نمی‌فرستد. فقط بخشی از پیامک‌ها، یعنی کد ورود هر بار، را غیرضروری می‌کند. پیام‌هایی مثل اطلاع‌رسانی به مشتریانی که اپ ندارند هنوز به پیامک نیاز دارند. اپ فعلاً فقط برای اندروید است، پس بهترین حالت، گذاشتن دکمه‌ی ورود با فینگت کنار روش پیامکی است. معرفی کلی روش در جایگزین OTP پیامکی آمده و برای شروع می‌توانید راهکارهای فینگت را مرور کنید.

پرسش‌های متداول درباره ارسال کد تأیید پیامکی

برای ارسال کد تأیید پیامکی کدام خط بهتر است؟

خط خدماتی، چون کد تأیید پیام درخواستی است. خط تبلیغاتی با قواعد لغو و فهرست مسدودی همراه است و ممکن است کد دیر برسد یا نرسد.

متن پیامک کد تأیید چه باید داشته باشد؟

نام سایت، کد، مدت اعتبار و یک هشدار کوتاه. لینک و تبلیغ در آن نگذارید و متن را کوتاه نگه دارید تا به چند پیام شکسته نشود.

کد تأیید چند دقیقه اعتبار داشته باشد؟

معمولاً دو تا پنج دقیقه. این عدد را با لاگ‌های خودتان تنظیم کنید: اگر کدهای رسیده ولی منقضی زیاد است، کمی بلندتر کنید.

فاصله‌ی ارسال مجدد چقدر باشد؟

حدود ۶۰ تا ۹۰ ثانیه برای ارسال دوم و فاصله‌ی بیشتر برای بعدی‌ها، همراه سقف ساعتی و روزانه برای هر شماره. کد قبلی را با هر ارسال جدید باطل کنید.

گزارش تحویل پیامک را از کجا بگیرم؟

از سرویس پیامک خودتان. بیشتر پنل‌ها وضعیت هر پیام را با پاسخ به درخواست یا آدرس بازگشتی می‌دهند. نام وضعیت‌ها فرق می‌کند، پس مستندات سرویس را ببینید.

اگر پیامک نرسید، کاربر چه راه‌هایی دارد؟

اصلاح شماره، ارسال مجدد بعد از شمارنده، ورود با روش دیگر، تماس صوتی (اگر سرویس شما دارد) و راه تماس با پشتیبانی. حداقل یکی از این‌ها باید روی صفحه دیده شود.

ورود با فینگت پیامک می‌فرستد؟

نه. کاربر شماره‌اش را یک بار هنگام ثبت‌نام در اپ تایید می‌کند و بعد ورود به سایت‌های متصل با تأیید روی گوشی انجام می‌شود. فینگت پنل پیامک نیست و پیامک ارسال نمی‌کند.