چک‌لیست راه‌اندازی
قدم‌به‌قدم از نصب تازه تا اولین فروش؛ هر کاری که باید داخل ربات و سرور انجام دهید
ربات را نصب کرده‌اید و /start جواب می‌دهد؛ حالا نوبت آماده‌کردنش برای فروش است. این صفحه همهٔ کارها را به ترتیب درست آورده و برای هر قدم به صفحهٔ کاملش لینک داده است.
مهم‌ترین نکته: فروش به‌صورت پیش‌فرض خاموش است
بعد از نصب، گزینهٔ وضعیت فروش در ⚙️ تنظیمات ربات خاموش (❌) است. تا روشنش نکنید، کاربر با زدن 🛍 خرید سرویس پیام «⛔️ فروش توسط ادمین بسته است.» می‌گیرد. دکمه‌های پرداخت (کارت دستی، ارزی، استارز، TonPays) و دکمهٔ تست هم پیش‌فرض خاموش‌اند.
همهٔ مسیرهای زیر از پنل مدیریت شروع می‌شوند: در ربات /panel بزنید یا دکمهٔ ⚙️ پنل مدیریت را بزنید (فقط برای آیدی‌هایی که در ADMIN_ID هستند دیده می‌شود).
قدم‌ها
اتصال پنل پاسارگارد
پنل مدیریت → 📚 منوی پنل ها → ▫️ افزودن پنل جدید
- یک اسم برای پنل بدهید (این اسم به کاربر نشان داده می‌شود، مثلاً
آلمان - ملی 🇩🇪). - آدرس پنل را بفرستید، فقط دامنه/آی‌پی و در صورت نیاز پورت، مثل
https://panel.example.com:8000. مسیر (path) مثل/dashboardاضافه نکنید. - نوع ورود را انتخاب کنید: 👤 نام کاربری و رمز یا 🔑 API Key.
- ربات به پنل وصل می‌شود و لیست گروه‌های پنل را می‌آورد. گروه(های) پیش‌فرض را انتخاب کنید. کانفیگ‌هایی که ربات می‌سازد در همین گروه‌ها قرار می‌گیرند.
اگر خطای اتصال گرفتید، بخش «ورود به پنل ناموفق است» در سوالات متداول را ببینید. راهنمای کامل: منوی پنل‌ها.
بررسی تنظیمات همان پنل
📚 منوی پنل ها → 📉 وضعیت پنل ها → (انتخاب پنل)
- ⚡ فعال‌سازی پنل (✅): پنل باید روشن باشد.
- 🛒 خرید سرویس (✅): اگر برای همهٔ پنل‌ها خاموش باشد، دکمه‌های 🛍 خرید سرویس و 🔑 سرویس های من از منوی کاربر حذف می‌شوند.
- 📦 گروه پیش‌فرض: هر وقت خواستید گروه‌ها را عوض کنید.
- 📡 اطلاع‌رسانی (🤖/🔔): حالت هشدار حجم و زمان. حالت وب‌هوک (🔔) پیشنهاد می‌شود؛ قدم «وب‌هوک» را پایین‌تر ببینید.
ساخت پلن فروش
پنل مدیریت → 🗞 ساخت پلن
برای هر پنل حداقل یک پلن (حجم، مدت، قیمت) بسازید. تا پنلی پلن نداشته باشد چیزی برای فروش ندارد. راهنما: ساخت پلن.
اگر نمایندگی هم می‌فروشید: 🏢 پلن نمایندگی (پلن نمایندگی).
روشن کردن ربات و فروش
پنل مدیریت → ⚙️ تنظیمات ربات → ⚙️ کنترل‌های اصلی ربات و فروش
| گزینه | پیش‌فرض | چه کار کنید |
|---|---|---|
| وضعیت ربات | ✅ روشن | روشن بماند. اگر خاموش شود، ربات برای کاربران عادی پیام «در حال بروزرسانی» می‌دهد (ادمین‌ها همچنان کار می‌کنند) |
| وضعیت فروش | ❌ خاموش | روشنش کنید |
| خرید تک‌پنل | ❌ | اگر فقط یک پنل دارید و می‌خواهید مرحلهٔ انتخاب پنل رد شود، روشن کنید |
| قفل کانال | ❌ | اختیاری؛ قدم «قفل کانال» را ببینید |
جزئیات همهٔ بخش‌ها: تنظیمات ربات.
روش‌های پرداخت
پنل مدیریت → 💳 تنظیمات درگاه
- کارت به کارت دستی: با ➕ افزودن کارت کارت بانکی را اضافه کنید و با 📋 انتخاب کارت فعال کارت فعال را مشخص کنید. سقف و کف مبلغ با 💰 محدودیت کارت دستی تنظیم می‌شود.
- ارز دیجیتال: از 💼 مدیریت کیف پول‌ها آدرس کیف پول‌ها را ثبت کنید.
- بونوس شارژ: با 🎁 تنظیمات بونوس برای هر روش درصد هدیه بگذارید (اختیاری).
- TonPays: از 💎 درگاه TonPays کلید API را وارد کنید (TonPays).
بعد دکمهٔ هر روش را روشن کنید: ⚙️ تنظیمات ربات → 💳 پرداخت‌ها و روش‌های شارژ
| گزینه | روش |
|---|---|
| دکمه کارت دستی | کارت به کارت |
| دکمه درگاه ارزی | پرداخت ارزی |
| دکمه پرداخت استارز | Telegram Stars |
| درگاه TonPays | TonPays (فقط وقتی کلید هم ثبت شده باشد نمایش داده می‌شود) |
اگر هیچ روشی روشن نباشد، کاربر در 💰 افزایش موجودی فقط «❌ شارژ حساب غیرفعال می‌باشد» می‌بیند. راهنما: تنظیمات درگاه.
کانال‌های لاگ (ضروری)
پنل مدیریت → 📝 مدیریت لاگ‌ها
یک کانال یا سوپرگروه بسازید، ربات را ادمین آن کنید و آیدی عددی‌اش (معمولاً با -100 شروع می‌شود) را برای هر نوع لاگ ست کنید. برای شروع سریع می‌توانید ⚡ ست همه لاگ‌ها با یک آیدی را بزنید.
دو مورد حیاتی‌اند:
- 💳 کارت به کارت دستی: رسیدهای کارت به کارت اینجا می‌آیند تا تأیید یا رد کنید. اگر این مقصد (و
LOG_CHANNELدر.env) تنظیم نشده باشد، رسید کاربر ثبت نمی‌شود و پیام «❌ رسید شما ثبت نشد» می‌گیرد. - 🗄 بکاپ ربات: فایل بکاپ فقط به همین مقصد ارسال می‌شود. بدون آن بکاپی گرفته نمی‌شود.
تا وقتی هیچ مقصد لاگی تنظیم نشده باشد، پیام «⚠️ تنظیمات ربات کامل نیست» بالای پنل مدیریت نمایش داده می‌شود. راهنما: مدیریت لاگ‌ها.
بکاپ خودکار
پنل مدیریت → 📦 بکاپ ربات
- 🚀 بکاپ همین الان را یک بار بزنید تا مطمئن شوید فایل به کانال بکاپ می‌رسد.
- ⚙️ تنظیم فاصله: پیش‌فرض هر ۲۴ ساعت است. عدد
0بکاپ خودکار را خاموش می‌کند.
راهنما و ریستور: بکاپ و ریستور.
وب‌هوک پنل پاسارگارد (برای هشدار حجم و زمان)
- روی سرور ربات
pasarguardbot urls(یا گزینهٔ9منو) را بزنید تا آدرس وب‌هوک را ببینید:http://IP:6160/api/webhook - مقدار Secret را از phpMyAdmin بردارید: جدول
secrets، ردیفwebhook_secret. - در پنل پاسارگارد: Settings → Webhook، آدرس را وارد کنید و هدر
x-webhook-secretرا با همان Secret بگذارید. - در ربات، دکمهٔ 📡 اطلاع‌رسانی همان پنل را روی 🔔 بگذارید.
اگر برای ربات SSL فعال کرده‌اید، پورت 6160 فقط HTTPS جواب می‌دهد؛ آدرس وب‌هوک را با https:// و دامنه وارد کنید.
راهنمای کامل با تصویر: اطلاع‌رسانی حجم و زمان.
قفل کانال (اختیاری)
اگر می‌خواهید کاربر قبل از استفاده عضو کانال شما شود:
- پنل مدیریت → 🔐 قفل چنل ها و کانال را اضافه کنید (ربات باید در کانال ادمین باشد).
- ⚙️ تنظیمات ربات → قفل کانال را روشن کنید.
راهنما: قفل کانال.
متن‌ها و دکمه‌ها
- 📝 متن‌های ربات: متن خوش‌آمد، قوانین، پیام‌ها و …
- ⌨️ مدیریت دکمه‌های کیبورد: تغییر متن، رنگ و آیکون دکمه‌ها.
- ⚙️ تنظیمات ربات → 🏠 دکمه‌های منوی اصلی: نمایش یا مخفی کردن پروفایل، راهنما، پشتیبانی و تنظیمات پیشرفته.
راهنما: متن‌ها و دکمه‌ها و لینک‌ها و برنامه‌ها.
سرویس تست (اختیاری)
- 📚 منوی پنل ها → 📉 وضعیت پنل ها → (انتخاب پنل) → 🧪 تنظیمات تست: دکمهٔ 🆓 ارائهٔ تست از این پنل را بزنید و 📥 حجم تست و ⏰ زمان تست را تنظیم کنید.
- ⚙️ تنظیمات ربات → 🛍 خرید، تمدید و سرویس تست → دکمه دریافت تست را روشن کنید.
دکمهٔ 🎁 دریافت تست فقط وقتی دیده می‌شود که هر دو مورد روشن باشد و کاربر قبلاً تست نگرفته باشد. با 🔄 ریست دریافت تست می‌توانید اجازهٔ تست دوباره بدهید. جزئیات: سرویس تست.
دعوت دوستان (اختیاری)
پنل مدیریت → 🎁 سیستم دعوت دوستان: پاداش دعوت را تنظیم و سیستم را روشن کنید. راهنما: دعوت دوستان.
وب‌اپ و پنل تحت وب (اختیاری، نیازمند HTTPS)
برای Mini App، دکمهٔ 🖥 پنل تحت وب و تأیید آنی TonPays باید WEBAPP_URL یک آدرس HTTPS با دامنه و گواهی معتبر باشد.
- دامنه و SSL را طبق دامنه و SSL تنظیم کنید.
- با دستور
/webappدر ربات تست کنید. - ⚙️ تنظیمات ربات → 🚀 مینی‌اپ را روی «دکمه در منو» یا «فقط مینی‌اپ» بگذارید.
راهنما: وب‌اپ و پنل تحت وب.
تست به‌عنوان یک کاربر عادی
با یک اکانت تلگرام دیگر (که در ADMIN_ID نیست) ربات را باز کنید و یک بار کل مسیر را بروید: شارژ کیف پول، خرید سرویس، دریافت لینک، تست، تمدید.
ادمین‌ها بعضی محدودیت‌ها را نمی‌بینند (مثلاً وقتی وضعیت ربات خاموش است ادمین همچنان کار می‌کند)، پس تست با اکانت عادی لازم است.
چک‌لیست نهایی
| مورد | کجا | |
|---|---|---|
| ☐ | پنل اضافه شده و گروه پیش‌فرض دارد | 📚 منوی پنل ها |
| ☐ | پنل فعال است و «🛒 خرید سرویس» آن ✅ است | تنظیمات پنل |
| ☐ | حداقل یک پلن ساخته شده | 🗞 ساخت پلن |
| ☐ | وضعیت فروش روشن است | ⚙️ تنظیمات ربات |
| ☐ | وضعیت ربات روشن است | ⚙️ تنظیمات ربات |
| ☐ | حداقل یک روش پرداخت تنظیم و دکمه‌اش روشن است | 💳 تنظیمات درگاه + ⚙️ تنظیمات ربات |
| ☐ | لاگ 💳 کارت به کارت دستی ست شده و ربات ادمین کانال است | 📝 مدیریت لاگ‌ها |
| ☐ | لاگ 🗄 بکاپ ربات ست شده و بکاپ دستی تست شده | 📝 مدیریت لاگ‌ها + 📦 بکاپ ربات |
| ☐ | وب‌هوک در پنل پاسارگارد ست شده و اطلاع‌رسانی روی 🔔 است | Settings → Webhook |
| ☐ | (اختیاری) قفل کانال، تست، دعوت دوستان | پنل مدیریت |
| ☐ | (اختیاری) دامنه، SSL و WEBAPP_URL | دامنه و SSL |
| ☐ | با یک اکانت عادی خرید تست شد | تلگرام |