خودکارسازی‌ها و زمان‌بندها
کارهایی که ربات بدون دخالت شما در پس‌زمینه انجام می‌دهد، هر چند وقت یک‌بار و با چه اثری.
PasarguardBot چند کار زمان‌بندی‌شده دارد که از لحظهٔ روشن شدن ربات، مدام در پس‌زمینه اجرا می‌شوند: بررسی انقضای سرویس‌ها، تایید پرداخت‌های ارزی، صورت‌حساب نمایندگی‌ها، بکاپ و… . دانستن این‌ها کمک می‌کند بفهمید چرا یک پیام یا تغییر «خودبه‌خود» اتفاق افتاده است.
جدول زمان‌بندها
| کار | فاصلهٔ اجرا | چه می‌کند |
|---|---|---|
| بررسی انقضای سرویس‌ها | هر ۱ دقیقه | سرویس‌های تست منقضی‌شده را فوراً حذف می‌کند؛ سرویس‌های پولی منقضی را بعد از مهلت پنل (پیش‌فرض ۳ روز) از پنل و ربات حذف می‌کند (اگر حذف خودکار برای آن پنل روشن باشد)؛ برای پنل‌های بدون وب‌هوک، پیام انقضا و هشدار مهلت را به کاربر می‌فرستد |
| هشدار کم شدن حجم | هر ۱ دقیقه | وقتی حجم باقی‌ماندهٔ سرویس کمتر از ۱ گیگابایت شود یا تمام شود به کاربر پیام می‌دهد (فقط پنل‌های بدون وب‌هوک) |
| به‌روزرسانی کوکی پنل‌ها | هر ۵ دقیقه | توکن ورود به پنل‌هایی را که نیاز دارند تازه می‌کند تا اتصال ربات به پنل قطع نشود؛ نتیجه در 📋 سایر لاگ‌ها گزارش می‌شود |
| به‌روزرسانی نرخ ارز | هر ۱۰ دقیقه | نرخ دلار، TRX و TON را می‌گیرد و برای محاسبهٔ مبلغ پرداخت‌های ارزی ذخیره می‌کند |
| تایید خودکار کارت به کارت | هر ۱ دقیقه | تراکنش‌های کارت به کارتی را که طبق قوانین تایید خودکار شما زمانشان رسیده تایید می‌کند (فقط وقتی تایید خودکار در تنظیمات درگاه روشن باشد) |
| بررسی پرداخت TRX | هر ۱ دقیقه | تراکنش‌های ورودی کیف پول TRX را روی شبکه بررسی، پرداخت‌های مطابق را تایید و کیف پول کاربر را شارژ می‌کند |
| بررسی پرداخت USDT (ترون) | هر ۱ دقیقه | همان کار برای USDT شبکهٔ TRC20 |
| بررسی پرداخت TON | هر ۱ دقیقه | همان کار برای TON |
| بررسی USDT-TON و USDT-BEP20 | هر ۱ دقیقه | همان کار برای تتر شبکه‌های تون و بایننس |
| بررسی پرداخت POL | هر ۱ دقیقه | همان کار برای POL (پالیگان) |
| بررسی فاکتورهای TonPays | هر ۱ دقیقه | پشتیبان callback؛ اگر اعلان پرداخت TonPays نرسیده باشد، وضعیت فاکتورهای باز را می‌پرسد |
| انقضای فاکتور استارز | هر ۱ دقیقه | فاکتورهای پرداخت با استارز را که ۳۰ دقیقه پرداخت نشده‌اند منقضی و پیامشان را پاک می‌کند |
| صورت‌حساب نمایندگی‌ها | هر ۱ دقیقه | هزینهٔ نمایندگی‌های ساعتی و مصرفی را از کیف پول کسر می‌کند، در صورت نبود موجودی پنل را معلق و بعد از شارژ دوباره فعال می‌کند؛ نمایندگی‌های منقضی را ۷ روز بعد حذف می‌کند |
| هشدار موجودی کم نمایندگی | هر ۵ دقیقه | به صاحبان نمایندگی ساعتی/مصرفی هشدار می‌دهد وقتی با سرعت خرج فعلی، موجودی کیف پولشان کمتر از ۶ ساعت دیگر کافی است (قابل تنظیم در تنظیمات ربات؛ فقط هشدار، کسری یا تعلیقی انجام نمی‌دهد) |
| بکاپ خودکار | طبق تنظیم (پیش‌فرض هر ۲۴ ساعت) | بکاپ ZIP دیتابیس را به کانال 🗄 بکاپ ربات می‌فرستد؛ عدد 0 بکاپ خودکار را خاموش می‌کند (بکاپ و ریستور) |
جزئیات اجرا
- فاکتورهای پرداخت ارزی (TRX، USDT، TON، USDT-TON، USDT-BEP20، POL) اگر ۳۰ دقیقه پرداخت نشوند منقضی می‌شوند.
- کارها با چند ثانیه فاصله از هم شروع می‌شوند و هر کار هم‌زمان فقط یک نسخه دارد؛ اگر اجرایی طول بکشد، اجرای بعدی روی آن سوار نمی‌شود.
- زمان آخرین و بعدی اجرای هر کار در بخش ابزارهای پنل تحت وب دیده می‌شود (این زمان‌ها با ری‌استارت ربات صفر می‌شوند).
انقضا و حذف سرویس‌ها با جزئیات
سرویس تست
به محض منقضی شدن، از پنل و ربات حذف می‌شود و به کاربر اطلاع داده می‌شود. مهلتی ندارد.
سرویس پولی — لحظهٔ انقضا
کاربر پیام انقضا می‌گیرد (برای پنل‌های بدون وب‌هوک؛ در پنل‌های با وب‌هوک این پیام از طریق وب‌هوک پنل ارسال می‌شود).
مهلت تمدید
در طول مهلت (پیش‌فرض ۳ روز، قابل تنظیم بین ۱ تا ۳۶۵ روز برای هر پنل) کاربر هشدار می‌گیرد که سرویس بعد از چند روز حذف می‌شود و می‌تواند تمدید کند.
حذف
بعد از پایان مهلت، اگر حذف خودکار برای آن پنل روشن باشد (پیش‌فرض روشن)، سرویس از پنل و ربات حذف، به کاربر اطلاع داده و در 📋 سایر لاگ‌ها ثبت می‌شود. اگر حذف خودکار را خاموش کنید، سرویس منقضی باقی می‌ماند.
مهلت و حذف خودکار در تنظیمات هر پنل هستند؛ اطلاع‌رسانی پنل را ببینید.
وب‌هوک پنل یا زمان‌بند؟
اطلاع‌رسانی‌های سرویس (انقضا، کم شدن و تمام شدن حجم) دو راه دارند و برای هر پنل جدا انتخاب می‌شوند:
| وب‌هوک پنل روشن | وب‌هوک پنل خاموش (حالت ربات) | |
|---|---|---|
| منبع اطلاع | خود پنل پاسارگارد لحظهٔ رویداد به ربات خبر می‌دهد | زمان‌بندهای ربات هر دقیقه پنل را بررسی می‌کنند |
| سرعت | فوری | حداکثر حدود یک دقیقه تاخیر |
| بار روی پنل | کم | با تعداد سرویس زیاد، درخواست‌های دوره‌ای بیشتر |
| پیش‌نیاز | تنظیم آدرس وب‌هوک (/api/webhook روی پورت ربات) و کلید (secret) در پنل پاسارگارد، و روشن کردن وب‌هوک در تنظیمات همان پنل در ربات | هیچ |
- وقتی وب‌هوک یک پنل روشن است، زمان‌بندهای «انقضا» و «کم شدن حجم» پیام آن پنل را نمی‌فرستند تا پیام تکراری نرسد.
- حذف سرویس‌های تست و پولیِ بعد از مهلت همیشه توسط زمان‌بند انجام می‌شود، چه وب‌هوک روشن باشد چه خاموش.
- اگر وب‌هوک را روشن کرده‌اید ولی پیامی به کاربران نمی‌رسد، تنظیمات وب‌هوک در پنل را بررسی کنید یا موقتاً آن را خاموش کنید تا زمان‌بندها کار را به عهده بگیرند.
کلید وب‌هوک را از کجا ببینم؟
کلید وب‌هوک در دیتابیس ذخیره است: phpMyAdmin ← دیتابیس pasarguardbot ← جدول secrets ← ردیف webhook_secret. آدرس‌های وب‌هوک با گزینهٔ 9 منوی مدیریت (pasarguardbot urls) نمایش داده می‌شوند. راهنمای کامل در اطلاع‌رسانی پنل.
خاموش کردن ربات و زمان‌بندها
گزینهٔ وضعیت ربات در ⚙️ تنظیمات ربات فقط پاسخ دادن به کاربران را متوقف می‌کند. زمان‌بندها همچنان اجرا می‌شوند: پرداخت‌های ارزی تایید می‌شوند، صورت‌حساب نمایندگی‌ها ادامه دارد و سرویس‌های منقضی طبق مهلت حذف می‌شوند. اگر می‌خواهید هیچ کاری انجام نشود، باید خود سرویس ربات را روی سرور متوقف کنید.
با ری‌استارت یا آپدیت ربات، همهٔ زمان‌بندها دوباره و خودکار شروع می‌شوند و کاری لازم نیست. ارسال همگانیِ نیمه‌کاره هم از همان نقطه ادامه پیدا می‌کند.