پلن نمایندگی
ساخت پلن و افزودن ادمین موجود پنل به ربات
از مسیر پنل مدیریت → 🏢 پلن نمایندگی میتوانید پلن بسازید، پلنها را مدیریت کنید، یا ادمینی که خودتان داخل پنل ساختهاید را بدون ساخت مجدد به ربات وصل کنید.
مرتبط با راهنمای نمایندگی کاربر.
منوی اصلی
| دکمه | کاربرد |
|---|---|
| ساخت پلن نمایندگی | ساخت پلن جدید (نقش، نوع قیمت، محدودیتها) |
| مدیریت پلنها | مشاهده، ویرایش قیمت، وضعیت، نمایش دکمه، حذف |
| افزودن ادمین موجود | وصل کردن ادمین از قبل ساختهشده در پنل به ربات |
| بستن | خروج از منو |
افزودن ادمین موجود
این قابلیت برای زمانی است که خودتان ادمین نمایندگی را از داخل پنل (Pasarguard / Marzban) ساختهاید و فقط میخواهید همان ادمین را داخل ربات ثبت کنید تا کاربر از بخش «نمایندگیهای من» مدیریتش کند.
ربات ادمین جدید در پنل نمیسازد؛ همان ادمین موجود را لینک میکند. از کیف پول کاربر هم چیزی کسر نمیشود.
پیشنیازها
قبل از شروع این موارد را آماده کنید:
- پنل در ربات متصل و در دسترس باشد.
- ادمین نمایندگی را از قبل داخل همان پنل ساخته باشید (نام کاربری مشخص).
- حداقل یک پلن نمایندگی برای همان پنل در ربات ساخته باشید (برای صورتحساب و مدیریت داخل ربات).
- کاربر مقصد قبلاً ربات را
/startکرده باشد. - همان ترکیب «پنل + نام کاربری ادمین» قبلاً در ربات ثبت نشده باشد.
مراحل بهصورت کامل
مرحله ۱ — ورود به منو
- وارد پنل مدیریت شوید (
/panelیا دکمه پنل مدیریت). - دکمه 🏢 پلن نمایندگی را بزنید.
- از منو، ➕ افزودن ادمین موجود را انتخاب کنید.
متن صفحه:
➕ افزودن ادمین موجود
ادمینی که از قبل در پنل ساخته شده را به ربات وصل میکند.
پنل را انتخاب کنید:مرحله ۲ — انتخاب پنل
پنلی که ادمین را داخل آن ساختهاید انتخاب کنید.
مرحله ۳ — ارسال نام کاربری ادمین پنل
ربات از شما میخواهد نام کاربری همان ادمین پنل را بفرستید:
➕ افزودن ادمین موجود — {نام پنل}
نام کاربری ادمینی که داخل پنل ساختهاید را ارسال کنید.
مثال: agency01نام کاربری را دقیقاً مثل پنل ارسال کنید (مثلاً agency01).
اگر نام کاربری در پنل پیدا نشود، یا از قبل در ربات ثبت شده باشد، خطا میگیرید و میتوانید دوباره ارسال کنید.
پس از پیدا شدن ادمین، پیشنمایش نشان داده میشود؛ معمولاً شامل این موارد است:
- نام پنل و نام کاربری
- وضعیت ادمین
- نقش (در صورت وجود)
- ترافیک مصرفشده / سقف
- تعداد یوزر (/ سقف در صورت وجود)
- انقضا (در صورت وجود)
- نوت فعلی
سپس از شما میخواهد آیدی تلگرام را بفرستید:
اگر اطلاعات درست است، آیدی عددی تلگرام کاربر را ارسال کنید.
⚠️ آن کاربر باید قبلاً ربات را /start کرده باشد.مرحله ۴ — ارسال آیدی عددی تلگرام
آیدی عددی کاربر مقصد را ارسال کنید (نه یوزرنیم).
| حالت | نتیجه |
|---|---|
| عدد نامعتبر | دوباره از شما میخواهد |
کاربر /start نکرده | کاربر {id} ربات را استارت نکرده است. |
| معتبر | به مرحله انتخاب پلن میروید |
مرحله ۵ — انتخاب پلن صورتحساب
لیست پلنهای نمایندگی همان پنل نمایش داده میشود. روی هر دکمه نوع قیمت هم دیده میشود (ثابت / مصرفی / …).
این پلن فقط برای مدیریت و صورتحساب داخل ربات است؛ محدودیتهای فعلی ادمین در پنل (data_limit، max_users، وضعیت و …) عوض نمیشوند.
مرحله ۶ — تایید نهایی
قبل از اجرا صفحه تایید با این هشدارها میآید:
- رمز ادمین در پنل عوض میشود (رمز فعلی از پنل قابل خواندن نیست)
- نوت روی آیدی تلگرام تنظیم میشود
- محدودیتهای فعلی پنل حفظ میمانند
- به کاربر پیام فعالسازی با رمز جدید ارسال میشود
دکمهها:
- ✅ تایید و افزودن — اجرای عملیات
- بازگشت به لیست پلن — انتخاب دوباره پلن
مرحله ۷ — نتیجه
پس از تایید موفق:
- ردیف نمایندگی در ربات ساخته میشود.
- رمز ادمین در پنل به رمز جدید تغییر میکند و در ربات ذخیره میشود.
- نوت ادمین پنل روی آیدی تلگرام کاربر تنظیم میشود.
- به کاربر پیام فعالسازی ارسال میشود (نام پنل، کد نمایندگی، آدرس ورود، نام کاربری، رمز جدید، نوع پلن، و اینکه از «نمایندگیهای من» قابل مدیریت است).
- در پیام خودتان (ادمین) هم کد نمایندگی و رمز جدید نمایش داده میشود.
- اگر ارسال پیام به کاربر ناموفق باشد، افزودن همچنان موفق است؛ رمز را از پیام خودتان دستی به او بدهید.
- لاگ با عنوان «افزودن ادمین موجود» ثبت میشود.
کاربر بعداً همان نمایندگی را در نمایندگیهای من میبیند و مثل خرید عادی مدیریت میکند.
خلاصه مسیر
🏢 پلن نمایندگی
→ ➕ افزودن ادمین موجود
→ انتخاب پنل
→ ارسال نام کاربری ادمین پنل
→ ارسال آیدی عددی تلگرام کاربر
→ انتخاب پلن صورتحساب
→ ✅ تایید و افزودنچه کارهایی انجام نمیشود
- ادمین جدید در پنل ساخته نمیشود
- از کیف پول کاربر مبلغی کسر نمیشود
- کد تخفیف اعمال نمیشود
- محدودیتها و وضعیت فعلی پنل از روی پلن ربات بازنویسی نمیشوند
ساخت و مدیریت پلن
- ساخت پلن: پنل → نقش → نوع قیمتگذاری → قیمت و محدودیتها
- مدیریت: تغییر قیمت، فعال/غیرفعال، تنظیم نمایش دکمه خرید، حذف (اگر نمایندگی متصل داشته باشد قابل حذف نیست)
پلنهای فعال در مسیر خرید کاربر نمایش داده میشوند؛ جزئیات در نمایندگی کاربر.