نشانه
یک فروشگاه فرضی سایتش را به هاست تازه منتقل کرده است. از همان روز، مشتریها مینویسند کد تایید در وردپرس نمیرسد. افزونه هیچ پیام خطایی نشان نمیدهد و تنظیمات هم دستنخورده است.
وقتی پیامک وردپرس ارسال نمیشود، زنجیرهی ارسال یک جایی قطع شده است: افزونه درخواست را نمیسازد، سایت آن را به پنل نمیرساند، پنل آن را قبول نمیکند، یا اپراتور آن را به گوشی نمیرساند. کار شما این است که پیدا کنید زنجیره از کدام حلقه میشکند. این صفحه یک مسیر مشخص میدهد: از سادهترین بررسیها مثل اعتبار پنل شروع میکنیم و به لاگ سرور، کرون وردپرس، کش و محدودیتهای هاست میرسیم. با هر قدم یک احتمال حذف میشود.
اولین قدم این است که بفهمید درخواست ارسال اصلاً به پنل پیامکی رسیده است یا نه. پنل را باز کنید و گزارش ارسال امروز را ببینید. اگر ردیفی برای شمارهی آزمایشی شما هست، مشکل سمت پنل یا اپراتور است. اگر هیچ ردیفی نیست، مشکل پیش از پنل است، یعنی داخل سایت یا مسیر شبکهی هاست.
این یک بررسی دو دقیقهای است و جلوی بیشتر سردرگمیها را میگیرد. هر کس که با پیامک وردپرس ارسال نمیشود روبهرو شده، همین را از اول پرسیده است. خیلیها ساعتها تنظیمات افزونه را زیر و رو میکنند، در حالی که پنل از اول خالی بوده و مشکل از بلاک شدن اتصال هاست است. بعضی دیگر هم سایت را مقصر میدانند، در حالی که پنل درخواست را گرفته و اعتبارش تمام شده است.
هر بار فقط یک چیز را تغییر دهید و بعد یک پیامک آزمایشی بفرستید. اگر چند تنظیم را همزمان عوض کنید، نمیفهمید کدام مشکل را حل کرده است.
این پنج مورد سادهاند و بیشتر وقتها همینها علتاند. اگر پیامک وردپرس ارسال نمیشود، با این فهرست شروع کنید. قبل از رفتن سراغ کد و لاگ، همه را یک بار نگاه کنید.
اگر هر پنج مورد درست بود، سراغ مرحلهی بعد بروید. اگر مشکل فقط در پیامکهای یک رویداد خاص است، مثلاً فقط کد ورود، به بخش تنظیمات افزونه در ادامه برگردید.
اطلاعات اتصال به پنل رایجترین جای اشتباه است. یک کاراکتر اضافه در کلید API کافی است تا هر درخواست رد شود. این مراحل را به ترتیب انجام دهید.
کلید قبلی را پاک کنید و دوباره از پنل کپی کنید. هنگام کپی، فاصلهی اول و آخر متن را نگیرید. فاصلهی نامرئی در انتهای کلید خطای رایجی است.
بعضی پنلها چند نوع کلید دارند، مثلاً کلید وبسرویس و کلید ارسال با قالب. افزونهی شما فقط یکی را میخواهد؛ در راهنمای خود افزونه یا پنل ببینید کدام.
شمارهی خطی که در افزونه نوشتهاید باید همان خطی باشد که در پنل برای شما فعال است. خط غیرفعال، تعلیقشده یا متعلق به حساب دیگر، درخواست را رد میکند.
بعضی پنلها فقط از آیپیهای ثبتشده درخواست میپذیرند. اگر سایت را به هاست جدید بردهاید، آیپی سرور عوض شده و باید دوباره در پنل ثبت شود.
اگر از داخل پنل هم پیامک نمیرود، مشکل کاملاً سمت پنل یا خط است و افزونه بیتقصیر است. با پشتیبانی پنل تماس بگیرید.
اگر در پنل پیام خطایی با کد عددی میبینید، متن همان خطا را از مستندات پنل بخوانید. هر پنل کدهای خطای خودش را دارد و حدس زدن معنی آنها وقت میگیرد.
پیامک ورود وردپرس ارسال نمیشود، یا دیر میرسد، اگر برای کد تأیید از خط نامناسب استفاده کنید. کد ورود پیام خدماتی است، نه تبلیغاتی. خطوط تبلیغاتی محدودیت زمانی و فهرست سیاه دارند و کاربرانی که پیامک تبلیغاتی را بستهاند، آن را نمیگیرند.
بیشتر پنلها برای کد تأیید دو روش پیشنهاد میکنند: ارسال با الگوی از پیش تأییدشده، یا ارسال از خط خدماتی. اسمها از پنلی به پنل دیگر فرق میکند. از پشتیبانی پنل بپرسید برای کد ورود کدام روش درست است. ارسال با الگو معمولاً به این معنی است که متن ثابت است و فقط عدد کد عوض میشود.
در این حالت اگر متن پیام در افزونه کمی با الگوی ثبتشده فرق داشته باشد، پنل آن را رد میکند. یک کاراکتر اضافه، یک نیمفاصلهی دیگر یا یک نشانهی نگارشی عوضشده کافی است. متن را از پنل کپی کنید و در افزونه بگذارید، نه برعکس.
بعضی پنلها ارسال متنهایی را که شامل لینک یا کلمات خاص است، بهطور خودکار متوقف میکنند. در پیام کد تأیید لینک نگذارید. فقط نام سایت، کد و یک جملهی کوتاه کافی است. دربارهی تفاوت خط خدماتی و تبلیغاتی، صفحهی پیامک خدماتی و تبلیغاتی را هم ببینید.
یکی از علتهای پنهان وقتی پیامک وردپرس ارسال نمیشود، هاست است. افزونه برای ارسال، از سرور سایت شما به آدرس پنل پیامکی درخواست میفرستد. بعضی هاستها این اتصالهای خروجی را کاملاً یا نسبتاً محدود میکنند. اگر اینطور باشد، هیچ درخواستی به پنل نمیرسد و گزارش پنل خالی میماند.
بعضی هاستهای اشتراکی اتصال خروجی به پورتهایی غیر از ۸۰ و ۴۴۳ یا به آدرسهای خارج از فهرست سفید را میبندند. از پشتیبانی هاست بپرسید اتصال خروجی به آدرس پنل مجاز است یا نه.
هاستها گاهی ابزارهای اتصال شبکهی پیاچپی، مثل curl یا allow_url_fopen، را خاموش میکنند. افزونه بدون آنها نمیتواند درخواست بفرستد. وضعیت را در «اطلاعات سایت» وردپرس ببینید یا از هاست بپرسید.
اگر هاست گواهیهای مرجع را بهروز نداشته باشد، اتصال امن به پنل شکست میخورد. در لاگ خطایی دربارهی «SSL certificate» یا «cURL error 60» میبینید.
اگر سرور نتواند نام پنل را به آدرس تبدیل کند، درخواست از همان اول شکست میخورد. پیام معمول لاگ در این حالت «could not resolve host» است.
بعضی پنلها فقط از آیپیهای داخل ایران درخواست میپذیرند و بعضی هاستهای خارجی روی پنلهای ایرانی مشکل اتصال دارند. هاست و پنل باید با هم سازگار باشند.
اگر پنل کند جواب بدهد و افزونه زود قطع کند، کاربر پیامی نمیبیند. این گاهی در شبهای شلوغ دیده میشود.
برای فهمیدن اینکه اتصال خروجی کار میکند یا نه، در بخش لاگ پایین یک آزمایش کوچک نوشتهایم. اگر خودتان دسترسی ترمینال دارید، از سرور یک درخواست ساده به آدرس پنل بزنید و ببینید جواب میآید یا نه.
لاگ مهمترین ابزار شماست، چون بهجای حدس زدن، دلیل واقعی را مینویسد. وردپرس لاگ خطای خودش را دارد که باید روشن شود. این تنظیم را در فایل wp-config.php و بالای خط «That's all, stop editing» بگذارید. بعد از پایان عیبیابی آن را خاموش کنید تا فایل لاگ در سرور بینهایت بزرگ نشود.
// خطاها را در فایل لاگ بنویس، نه روی صفحه برای بازدیدکننده
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
// لاگ در wp-content/debug.log ساخته میشود// آدرس را با آدرس وبسرویس پنل خودتان عوض کنید (اینجا فقط نمونه است)
$response = wp_remote_get( 'https://example-sms-panel.ir/', array( 'timeout' => 15 ) );
if ( is_wp_error( $response ) ) {
// اگر اتصال شکست بخورد، علتش اینجا نوشته میشود
error_log( 'اتصال به پنل شکست خورد: ' . $response->get_error_message() );
} else {
error_log( 'جواب پنل با کد ' . wp_remote_retrieve_response_code( $response ) . ' رسید' );
}کد بالا را بهعنوان آزمایش موقت، مثلاً در یک افزونهی کوچک آزمایشی یا با افزونههای اجرای قطعهکد، اجرا کنید و بعد حذفش کنید. اگر پیام «cURL error» یا «timed out» دیدید، مشکل در اتصال هاست است و باید با پشتیبانی هاست صحبت کنید. اگر جواب با هر کدی رسید، یعنی سرور میتواند با پنل حرف بزند و مشکل جای دیگری است.
اگر افزونهی پیامک شما بخش لاگ جدا دارد، آن را هم نگاه کنید. بعضی افزونهها پاسخ پنل را ثبت میکنند و همانجا مینویسند چرا ارسال رد شده است. نام و جای این بخش در هر افزونه فرق میکند؛ از مستندات افزونهی خودتان بخواهید.
همهی پیامکهای وردپرس لحظهای فرستاده نمیشوند. بعضی افزونهها پیام را در صف میگذارند و با کارهای زمانبندیشدهی وردپرس، یعنی WP-Cron، میفرستند. اگر کرون از کار افتاده باشد، پیامها در صف میمانند. پیامک وضعیت سفارش، یادآوری سبد خرید و پیامکهای زماندار بیشتر به این مشکل برمیخورند.
WP-Cron وقتی اجرا میشود که کسی از سایت بازدید کند. سایت کمبازدید ممکن است ساعتها اجرا نشود. سایتی که کش سنگین دارد هم گاهی بازدیدها را از وردپرس رد میکند و کرون راه نمیافتد. بعضی هاستها هم برای کاهش بار، کرون را خاموش میکنند. اگر در wp-config.php عبارت DISABLE_WP_CRON با مقدار true دیده میشود، یعنی کسی کرون خودکار را خاموش کرده و باید کرون واقعی در هاست تنظیم شده باشد.
وقتی پیامک ووکامرس ارسال نمیشود، دو چیز را جدا بررسی کنید. اول اینکه رویداد درست رخ داده باشد: آیا وضعیت سفارش واقعاً به «در حال انجام» تغییر کرده، یا فقط روی صفحه عوض شده و ذخیره نشده است؟ دوم اینکه پیام فوری است یا در صف. برای پیامکهایی که ووکامرس هنگام پرداخت یا تغییر وضعیت میفرستد، ببینید در افزونه برای همان وضعیت خاص ارسال روشن است یا نه. ترتیب بررسیهای بیشتر دربارهی پیامک سفارش را در صفحهی پیامک سفارش ووکامرس میتوانید ببینید.
اگر هنوز پیامک وردپرس ارسال نمیشود و تنظیمات درست است و لاگ هم خطایی ندارد، به سراغ چیزهایی بروید که بین کاربر و افزونه یا بین افزونه و پنل قرار میگیرند.
اگر افزونهی کش، صفحهی ورود یا درخواستهای Ajax را ذخیره کند، کاربر پاسخ قدیمی میبیند و درخواست ارسال کد اصلاً اجرا نمیشود. صفحههای ورود، ثبتنام، سبد خرید و حساب کاربری را از کش خارج کنید.
کشهایی مثل Cloudflare، ArvanCloud یا کش سرور ممکن است درخواستهای POST یا مسیر admin-ajax را درست رد نکنند. قوانین کش را برای این مسیرها بررسی کنید.
بعضی افزونههای امنیتی درخواستهای خروجی یا درخواستهای ورود با تعداد بالا را مسدود میکنند. خاموش کردن موقت آنها برای آزمایش، مسئله را روشن میکند. پس از آزمایش دوباره روشنشان کنید.
پنلها معمولاً در هر ثانیه یا دقیقه تعداد مشخصی ارسال را میپذیرند. وقتی تعداد درخواستها بالا میرود، بقیه رد میشوند. این در روزهای فروش ویژه بیشتر پیش میآید.
پنل یا افزونه ممکن است برای هر شماره در ساعت تعداد محدودی کد بفرستد. کاربری که چند بار پشتسرهم کد خواسته، ممکن است فعلاً کدی دریافت نکند. این برای جلوگیری از سوءاستفاده خوب است، ولی پیام روشنی به کاربر بدهید.
اگر چند افزونه روی ورود یا ثبتنام کار میکنند، یکی ممکن است درخواست را بگیرد و آنیکی را اجرا نکند. همهی افزونهها را خاموش کنید و فقط افزونهی پیامک و ووکامرس را نگه دارید؛ بعد یکییکی روشن کنید.
برای افزایش امنیت و جلوگیری از سوءاستفادهی رباتها از فرم ارسال کد، صفحهی بمباران پیامکی راهکارهای کاملتری دارد.
| نشانه | علت محتمل | کجا را نگاه کنیم |
|---|---|---|
| در گزارش پنل هیچ ردیفی نیست | درخواست به پنل نمیرسد | لاگ سایت، تنظیمات افزونه، اتصال خروجی هاست |
| پنل «اعتبار ناکافی» مینویسد | موجودی یا بستهی پنل تمام شده | صورتحساب و موجودی پنل |
| پنل کد خطای احراز هویت میدهد | کلید API یا آیپی مجاز درست نیست | کلید جدید و فهرست آیپی پنل |
| پنل «قالب نامعتبر» یا مشابه آن مینویسد | متن با الگوی ثبتشده فرق دارد | متن الگو در پنل و در افزونه |
| وضعیت «ارسال شد» ولی «تحویل نشد» | مشکل اپراتور، خاموشی گوشی یا مسدودی | گزارش تحویل پنل و وضعیت گوشی |
| پیامکها با چند ساعت تأخیر میرسند | کرون یا صف ارسال | WP-Cron و تنظیم کرون هاست |
| فقط برخی کاربران پیامک نمیگیرند | قالب شماره، اپراتور یا مسدودی تبلیغات | شمارههای ناموفق و الگوی مشترک آنها |
این جدول را جای تشخیص قطعی نگیرید؛ نقطهی شروع است. اگر مشکل فقط از سمت گوشی کاربر است، صفحهی کد تأیید نمیآید از نگاه کاربر هم توضیح داده و هم راهنماییهایی دارد که میتوانید برای پشتیبانی سایت بفرستید.
این روایت فرضی است و فقط ترتیب فکر کردن را نشان میدهد.
یک فروشگاه فرضی سایتش را به هاست تازه منتقل کرده است. از همان روز، مشتریها مینویسند کد تایید در وردپرس نمیرسد. افزونه هیچ پیام خطایی نشان نمیدهد و تنظیمات هم دستنخورده است.
مدیر فروشگاه گزارش پنل را باز میکند و میبیند از روز انتقال به بعد هیچ ردیفی نیست. پس مشکل پیش از پنل است و اعتبار و خط ارسال بیگناهاند.
در بخش تنظیمات پنل میبیند آیپی مجاز هنوز آدرس هاست قدیمی است. درخواستهایی که از آیپی تازه میآیند رد میشوند و افزونه خطا را نشان نمیدهد.
آیپی جدید در پنل ثبت میشود و ارسال برمیگردد. فروشگاه در فهرست کارهای هر انتقال بعدی هاست یک خط اضافه میکند: «آیپی مجاز پنل پیامکی را بهروز کنیم».
رفع مشکل ارسال پیامک وردپرس معمولاً یکبار کافی نیست، چون مسیر پیامک چند حلقه دارد و هر حلقه ممکن است در یک ماه دیگر مشکل تازهای بسازد. اعتبار تمام میشود، هاست عوض میشود، افزونه بهروز میشود، اپراتور خط را عوض میکند. اگر ورود سایت فقط به پیامک تکیه کند، هر خرابی یعنی کاربرانی که نمیتوانند وارد شوند.
برای راه سوم گزینههای زیادی هست. ورود با رمز عبور سادهترین است. ورود با گوگل پیامکی نمیخواهد؛ جزئیاتش را در ورود با گوگل در وردپرس ببینید. فینگت هم گزینهای است که برای هر ورود پیامک نمیفرستد. کاربر یک بار شمارهاش را در اپ فینگت با کد پیامکی تأیید میکند و از آن به بعد ورود به سایت شما را در همان اپ تأیید میکند. سایت شما نام، شمارهی موبایل تأییدشده و شناسهی ثابت کاربر را میگیرد.
این روش پنل پیامکی شما را کنار نمیگذارد و جای آن را هم نمیگیرد. فینگت پنل پیامکی نیست. فقط تعداد پیامکهایی را که برای ورود لازم دارید کمتر میکند. اپ فعلاً فقط برای اندروید است و کاربران بدون اپ همچنان با روش قبلی وارد میشوند. برای شروع، راهنمای ورود با شماره موبایل وردپرس و صفحهی دانلود اپ فینگت را ببینید.
اگر پیامک وردپرس ارسال نمیشود، گزارش ارسال پنل را نگاه کنید. اگر برای شمارهی آزمایشی ردیفی هست، درخواست به پنل رسیده و مشکل سمت پنل یا اپراتور است. اگر ردیفی نیست، درخواست از سایت خارج نشده و باید لاگ، تنظیمات افزونه و اتصال هاست را بررسی کنید.
احتمالها: کلید API یا آیپی مجاز نادرست، خط ارسال غیرفعال، متنی که با الگوی پنل نمیخواند، یا بلاک شدن اتصال خروجی هاست. گزارش پنل و لاگ وردپرس نشان میدهند کدامیک است.
احتمالاً ارسال برای وضعیتهای سفارش در افزونه روشن نیست، شماره از فیلد اشتباه خوانده میشود، یا پیامهای سفارش در صف کرون ماندهاند. تنظیم هر رویداد را جدا ببینید و WP-Cron را بررسی کنید.
بله. اگر صفحهی ورود یا درخواستهای Ajax کش شوند، درخواست ارسال کد اجرا نمیشود یا جواب قدیمی برمیگردد. صفحههای ورود، سبد خرید و حساب کاربری را از کش خارج کنید.
اگر WP_DEBUG_DISPLAY را false بگذارید، خطاها فقط در فایل لاگ نوشته میشوند و بازدیدکننده چیزی نمیبیند. بعد از پایان عیبیابی، لاگ را خاموش و فایل debug.log را پاک کنید.
به پشتیبانی هاست بگویید که میخواهید سرور به آدرس پنل پیامکی درخواست HTTPS بفرستد و از آنها بخواهید اجازه دهند. اگر هاست قبول نکرد، چارهی معمول عوض کردن هاست یا استفاده از پنلی است که با هاست شما سازگار است.
بله. روشهایی مثل ورود با گوگل یا ورود با تأیید در اپ فینگت برای هر ورود پیامک نمیفرستند. فینگت پنل پیامکی را حذف نمیکند و فقط وابستگی ورود به رسیدن پیامک را کم میکند. اپ آن فعلاً اندروید است.