راهنمای گامبهگام نوویکس
از صفر تا صد ساخت و مدیریت ربات؛ برای کاربران مبتدی و حرفهای — با مثالهای عملی، ۱۹ تگ قیمت لحظهای و راهحل مشکلات رایج. کاملاً رایگان، بدون نیاز به سرور، بدون برنامهنویسی.
فهرست مطالب
۲۰ بخش- ۱ آشنایی با اصطلاحات
- ۲ پیشنیازها و شروع کار
- ۳ ساخت اولین ربات
- ۴ آشنایی با پنل ربات
- ۵ ایجاد قابلیت جدید
- ۶ توضیح فیلدهای فرم
- ۷ انواع پاسخها
- ۸ ساخت کیبوردها
- ۹ کیبوردهای مرحلهای
- ۱۰ تگها و محتوای پویا
- ۱۱ قیمت لحظهای بازار 🆕
- ۱۲ سیستم اخطار پیشرفته
- ۱۳ قابلیتهای امنیتی
- ۱۴ قابلیتهای مدیریتی
- ۱۵ کنترل قابلیت (Toggle)
- ۱۶ تنظیمات @BotFather
- ۱۷ تفاوت عادی و VIP
- ۱۸ آزمایش و عیبیابی
- ۱۹ مثالهای عملی
- ۲۰ سوالات متداول
آشنایی با اصطلاحات
قبل از شروع، با این اصطلاحات آشنا شوید تا درک بهتری از بقیه راهنما داشته باشید.
| اصطلاح | توضیح |
|---|---|
| توکن ربات | یک رشته رمزنگاریشده که از @BotFather دریافت میکنید. مثل «کلید» ربات است و باید محرمانه بماند. |
| قابلیت (Feature) | هر رفتار یا ویژگی که به ربات اضافه میکنید؛ مثل «پاسخ خودکار به سلام» یا «ضد لینک». |
| محرک (Trigger) | متنی که کاربر میفرستد و باعث فعال شدن قابلیت میشود (مثلاً کلمه «سلام»). |
| پاسخ (Response) | پیامی که ربات در پاسخ به محرک میفرستد. |
| تگ پویا | کدهایی مثل {name} که در زمان اجرا با مقدار واقعی (نام کاربر) جایگزین میشوند. |
| کیبورد | مجموعهای از دکمهها که به کاربر نمایش داده میشود تا با کلیک روی آنها با ربات تعامل کند. |
| ریپلای (Reply) | پاسخ دادن روی پیام مشخص کاربر. در برخی قابلیتها (مثل بن) نیاز است روی پیام کاربر ریپلای کنید. |
| مدیر گروه | کاربری که توسط مالک به عنوان مدیر تعیین شده و برخی دستورات مدیریتی را اجرا میکند. |
| مالک گروه | کاربری که ربات را در گروه فعال کرده و بالاترین سطح دسترسی را دارد. |
| کاربر معاف | کاربری که از تمام اخطارها و حذف پیام برای قابلیتهای امنیتی معاف شده است. |
| حد نصاب اخطار | تعداد تخلفاتی که اگر کاربر به آن برسد، به صورت خودکار بن میشود. |
| Webhook | روشی که روبیکا پیامهای کاربر را بلافاصله به ربات شما میفرستد. در نوویکس به صورت خودکار تنظیم میشود. |
| کیبورد مرحلهای | کیبوردی که میتوانید برای هر دکمه آن یک زیرکیبورد تعریف کنید. تا ۵ مرحله در VIP. |
| Toggle Feature | قابلیتی که به شما اجازه میدهد یک قابلیت امنیتی را از داخل گروه روشن یا خاموش کنید. |
| تگ قیمت | 🆕 تگهایی مثل {price_usd} که قیمت لحظهای بازار (دلار، طلا، سکه، ارز دیجیتال) را خودکار نمایش میدهند. |
پیشنیازها و شروع کار
قبل از ساخت ربات، این موارد را آماده کنید. هیچ نیازی به سرور، دامنه یا دانش فنی نیست.
@BotFather نیاز دارید و بس.
۱) حساب کاربری در نوویکس
ابتدا در سایت نوویکس ثبتنام کنید. ثبتنام رایگان است و فقط به یک نام کاربری و رمز عبور نیاز دارید. پس از ثبتنام، به صورت خودکار وارد داشبورد میشوید.
۲) دریافت توکن ربات از @BotFather
توکن ربات را از @BotFather در روبیکا دریافت کنید:
- در روبیکا به @BotFather بروید و روی دکمه «شروع» کلیک کنید.
- روی دکمه «بات جدید» کلیک کنید.
- نام ربات را وارد کنید (مثلاً «ربات گروه من»). این نام در سربرگ چت نمایش داده میشود.
- یوزرنیم ربات را وارد کنید. باید به
botختم شود (مثلاًmy_group_bot). - پس از تأیید، توکن ربات به شما نمایش داده میشود. آن را کپی و در جای امن ذخیره کنید.
/revoke آن را باطل و توکن جدید دریافت کنید.
مواردی که نیازی به آنها ندارید
| مورد | وضعیت |
|---|---|
| سرور (VPS یا اختصاصی) | ✅ فراهم توسط نوویکس |
| دامنه و هاست | ✅ فراهم توسط نوویکس |
| SSL / HTTPS | ✅ خودکار |
| دیتابیس MySQL | ✅ فراهم توسط نوویکس |
| تنظیم Webhook | ✅ خودکار |
| دانش برنامهنویسی | ✅ نه لازم است |
| هزینه ماهانه | ✅ صفر تومان |
ساخت اولین ربات
مراحل ساخت ربات در نوویکس از ابتدا تا انتها.
- وارد حساب کاربری خود در نوویکس شوید.
- در داشبورد، روی دکمه «ساخت ربات جدید» کلیک کنید (یا به آدرس
/builder/create/بروید). - توکن دریافتی از @BotFather را در فیلد مربوطه وارد کنید.
- روی دکمه «بررسی توکن» کلیک کنید. اگر توکن معتبر باشد، نام و یوزرنیم ربات نمایش داده میشود.
- روی دکمه «ساخت ربات» کلیک کنید.
- منتظر بمانید — در کمتر از ۱ دقیقه ربات ساخته میشود و وبهوک به صورت خودکار تنظیم میشود.
آشنایی با پنل ربات
هر دکمه و بخش پنل چه کاربردی دارد.
صفحه جزئیات ربات
پس از ساخت ربات، وارد صفحه جزئیات آن میشوید. این صفحه شامل بخشهای زیر است:
| بخش | کاربرد |
|---|---|
| تایمر VIP | اگر ربات VIP باشد، زمان باقیمانده به صورت زنده نمایش داده میشود. |
| اطلاعات ربات | وضعیت فعال/غیرفعال، تاریخ ساخت، تعداد کاربران، تعداد گروههای فعال. |
| مدیریت ربات | فعال/غیرفعال کردن ربات، تغییر توکن، حذف ربات. |
| مدیریت محتوا | افزودن قابلیت، مدیریت فایلها، ارسال پیام همگانی به کاربران/گروهها، تاریخچه ارسال. |
| پشتیبانی | مشاهده تیکتهای پشتیبانی (فقط برای رباتهای VIP). |
| مدیریت گروهها | مشاهده گروههای فعال و تعیین گروه VIP (فقط برای رباتهای VIP). |
| گزارشات | مشاهده آپدیتهای دریافتی ربات (پیامهای کاربران، گروهها و ...). |
| لیست قابلیتها | نمایش تمام قابلیتهای اضافهشده با امکان ویرایش، فعال/غیرفعال و حذف. |
ایجاد قابلیت جدید
مراحل کلی افزودن یک قابلیت به ربات.
- در صفحه جزئیات ربات، روی دکمه «افزودن قابلیت» کلیک کنید.
- صفحهای باز میشود که دو دسته قابلیت دارد:
• یک بار مصرف: فقط یک بار میتوانید این نوع را بسازید (مثل استارت).
• چندگانه: میتوانید نامحدود بسازید (مثل پاسخ به متن). - روی کارت قابلیت مورد نظر کلیک کنید.
- فرم تنظیمات باز میشود. فیلدهای مختلف را پر کنید (در بخش بعدی توضیح داده شده).
- روی دکمه «ذخیره قابلیت» کلیک کنید.
توضیح فیلدهای فرم
هر فیلد در فرم قابلیتها چه معنایی دارد و چگونه باید پر شود.
محل اجرا (Chat Type)
مشخص میکند قابلیت در کدام نوع چت اجرا شود.
| مقدار | توضیح |
|---|---|
همه جا | پی وی، گروه و کانال |
فقط پی وی | فقط مکالمات خصوصی |
فقط گروه | فقط گروهها |
فقط کانال | فقط کانالها |
حالت ارسال پاسخ (Reply Type)
مشخص میکند پاسخ ربات به چه صورت ارسال شود.
| مقدار | توضیح |
|---|---|
ارسال عادی | پیام جدید مستقل در چت |
ریپلای روی پیام | پاسخ روی پیام کاربر (به پیامش متصل میشود) |
متن محرک (Trigger Text)
متن یا کلمهای که با ارسال آن توسط کاربر، قابلیت فعال میشود. بسته به نوع قابلیت:
• شامل کلمه: اگر پیام شامل این متن باشد، قابلیت فعال میشود
• دقیق: پیام کاربر باید دقیقاً برابر این متن باشد
• مدیریتی: کاربر باید دقیقاً این متن را به همراه ریپلای بفرستد
• start/help: نیازی به متن محرک نیست (خودکار)
متن پاسخ (Response Text)
پیامی که ربات در پاسخ ارسال میکند.
در این فیلد میتوانید از تگهای پویا استفاده کنید (مثل {name}، {mention}، {price_usd})
تا پیام شخصیسازی شود.
محرکهای اضافی (Multi-Trigger)
برای اکثر قابلیتها میتوانید تا ۳۰ محرک تعریف کنید. هر محرک به تنهایی میتواند قابلیت را فعال کند.
- محرک اصلی را در فیلد «متن محرک» وارد کنید.
- روی دکمه «افزودن محرک جدید» کلیک کنید.
- محرکهای اضافی را یکییکی وارد کنید.
- روی «ذخیره» کلیک کنید.
سطح دسترسی (Access Level)
فقط برای قابلیتهای «شامل کلمه»، «دقیق» و «پاسخ تصادفی» در گروه:
| مقدار | توضیح |
|---|---|
همه کاربران | همه اعضای گروه میتوانند از این قابلیت استفاده کنند |
مدیران + مالک | فقط مالک و مدیران گروه |
فقط مالک | فقط مالک گروه |
تعداد اخطار (Warning Count)
برای قابلیتهای امنیتی و warn_user قابل تنظیم است (۰ تا ۲۰):
| مقدار | رفتار ربات |
|---|---|
| ۰ (پیشفرض) | فقط حذف پیام + ارسال اخطار (بدون بن و بدون ثبت اخطار) |
| ۱ | بن فوری در اولین تخلف + پاک کردن کل اطلاعات کاربر |
| ۲+ | هر تخلف ۱ اخطار اضافه میکند؛ در رسیدن به حد نصاب، بن خودکار |
فایل آیدی (File ID)
اگر میخواهید همراه با متن پاسخ، یک فایل (عکس، ویدئو، صوت، سند) ارسال شود:
- به بخش «مدیریت فایلها» در صفحه جزئیات ربات بروید.
- فایل مورد نظر را آپلود کنید.
- فایل آیدی تولید شده را کپی کنید.
- در فرم قابلیت، فایل آیدی را در فیلد مربوطه وارد کنید.
• اگر متن پاسخ خالی باشد، فقط فایل ارسال میشود
• اگر متن پاسخ پر باشد، فایل همراه با متن ارسال میشود
اولویت (Priority)
مشخص میکند در صورت تطابق چند قابلیت با یک پیام، کدام یک اولویت بالاتری دارد. قابلیتهای جدیدتر اولویت بالاتری دارند. میتوانید در زمان ویرایش، اولویت را تغییر دهید.
انواع پاسخها و شرایط اجرا
سه نوع قابلیت پاسخدهی و تفاوتهایشان.
اگر بخشی از پیام کاربر با محرک مطابقت داشته باشد، پاسخ ارسال میشود. حتی اگر کاربر کلمات دیگری هم نوشته باشد، مادامی که محرک در پیامش باشد، قابلیت اجرا میشود.
محرک: «سلام» پیام کاربر ۱: «سلام دوستان» ✅ اجرا میشود پیام کاربر ۲: «سلام» ✅ اجرا میشود پیام کاربر ۳: «درود» ❌ اجرا نمیشود
پیام کاربر باید دقیقاً برابر محرک باشد. حتی یک کاراکتر اضافه باعث عدم اجرا میشود. مناسب برای منوهای متنی با گزینههای مشخص.
محرک: «قیمت» پیام کاربر ۱: «قیمت» ✅ اجرا میشود پیام کاربر ۲: «قیمتش چنده» ❌ اجرا نمیشود پیام کاربر ۳: «قیمت » ❌ اجرا نمیشود (فاصله اضافه)
از بین چند پاسخ، یکی به صورت تصادفی انتخاب و ارسال میشود. مناسب برای پاسخهای متنوع و غیرتکراری.
امکانات ویژه:
| امکان | توضیح |
|---|---|
| نوع تطابق | میتوانید «شامل کلمه» یا «دقیق» را انتخاب کنید |
| فایل جداگانه | برای هر پاسخ، یک فایل آیدی مستقل تعریف میشود |
| تعداد پاسخ | حداکثر ۵۰ پاسخ برای هر قانون |
محرک: «اوضاع» نوع تطابق: شامل کلمه لیست پاسخها: • «خوبم ممنون» (بدون فایل) • «عالی هستم» (بدون فایل) • «خوب و خوش» (بدون فایل) • «مرسی، تو چطوری؟» (بدون فایل) نتیجه: هر بار که کاربر «اوضاع» بفرستد، یکی از این پاسخها به صورت تصادفی انتخاب میشود.
ساخت کیبوردها
دو نوع کیبورد قابل ساخت: شیشهای و درون پیام.
کیبورد شیشهای (Chat Keyboard)
دکمهها در پایین صفحه چت نمایش داده میشوند. با کلیک کاربر، پیام جدیدی با متن دکمه ارسال میشود. مناسب برای منوی اصلی و راهنمای سریع.
- در پنل، روی افزودن قابلیت کلیک کنید.
- کارت کیبورد شیشهای را انتخاب کنید.
- متن دکمه را وارد کنید (مثلاً «اطلاعات»).
- متن پاسخ را وارد کنید (پاسخی که بعد از کلیک ارسال میشود).
- ردیف دکمه را انتخاب کنید (۱ تا ۵).
- روی ذخیره کلیک کنید.
- برای افزودن دکمههای بیشتر، همین مراحل را تکرار کنید.
کیبورد درون پیام (Inline Keyboard)
دکمهها در داخل خود پیام نمایش داده میشوند. با کلیک کاربر، متن همان پیام ویرایش میشود. مناسب برای منوهای تعاملی و پرسشهای مرحلهای.
- کارت کیبورد درون پیام را انتخاب کنید.
- متن دکمه و متن پاسخ را وارد کنید.
- ردیف مورد نظر را انتخاب کنید (۱ تا ۵).
- روی ذخیره کلیک کنید.
سلام {name} باعث میشود نام کاربر روی دکمه نمایش داده شود.
کیبوردهای مرحلهای (Nested Keyboards)
ساخت منوهای چند سطحی با زیرکیبورد.
برای هر دکمه کیبورد، میتوانید یک زیرکیبورد تعریف کنید. با کلیک کاربر روی دکمه، زیرکیبورد نمایش داده میشود و به جای پاسخ متنی، دکمههای جدید میبیند. این قابلیت برای ساخت منوهای تو در تو بسیار کاربردی است.
ساخت زیرکیبورد
- یک دکمه کیبورد بسازید و ذخیره کنید.
- در لیست قابلیتها، روی دکمه ویرایش (آیکون مداد) کلیک کنید.
- در بخش «کیبورد مرحله بعد»، روی دکمه «تعریف کیبورد مرحله بعد» کلیک کنید.
- صفحهی جدید باز میشود. روی دکمه «افزودن دکمه» کلیک کنید.
- دکمههای زیرکیبورد را (مثل کیبورد عادی) بسازید.
- برای بازگشت به مرحله قبل، در بخش دکمه بازگشت، اطلاعات را پر کنید.
دکمه بازگشت (Back Button)
در هر مرحله میتوانید یک دکمه بازگشت اضافه کنید تا کاربر با کلیک روی آن به مرحله قبل برگردد.
- وارد صفحهی زیرکیبورد شوید (از طریق دکمه «مرحله بعد»).
- در بخش «دکمه بازگشت»، متن دکمه را وارد کنید (مثلاً «🔙 بازگشت»).
- متن پاسخ را وارد کنید (مثلاً «به مرحله قبل برگشتید»).
- ردیف دکمه را انتخاب کنید.
- روی «افزودن دکمه بازگشت» کلیک کنید.
محدودیت عمق
| نوع کاربر | حداکثر عمق زیرکیبورد |
|---|---|
| کاربر عادی | ۱ مرحله (یک سطح زیرکیبورد) |
| کاربر VIP | ۵ مرحله (پنج سطح زیرکیبورد) |
کیبورد اصلی: ├─ 📞 اطلاعات (ردیف ۱) │ ├─ درباره ما │ ├─ خدمات │ └─ 🔙 بازگشت ├─ 📖 راهنما (ردیف ۱) │ ├─ نحوه استفاده │ ├─ سوالات متداول │ └─ 🔙 بازگشت └─ 📧 تماس با ما (ردیف ۲) نتیجه: کاربر با کلیک روی «اطلاعات» وارد زیرکیبورد میشود و میتواند با دکمه بازگشت به کیبورد اصلی برگردد.
تگها و محتوای پویا
تگها کدهایی هستند که در متن پاسخ قرار میگیرند و در زمان اجرا با مقدار واقعی جایگزین میشوند.
مثال: اگر در متن پاسخ بنویسید سلام {name} عزیز، ربات آن را به «سلام علی عزیز»
(نام واقعی کاربر) تبدیل میکند.
دستهبندی تگها
| دسته | نمونهها |
|---|---|
| اطلاعات کاربر | {name}, {username}, {first_name}, {last_name}, {user_id}, {chat_id} |
| اطلاعات ربات | {bot_name}, {bot_username}, {users}, {groups} |
| اطلاعات گروه | {group_title}, {mention}, {owner}, {admins}, {muted}, {exempts} |
| آمار و رتبه | {rank}, {statistics}, {group_count}, {mention_rank:N} |
| ریپلای | {reply_mention}, {reply_stats}, {reply_role} |
| اخطار | {warn_count}, {my_warnings}, {reply_warnings}, {group_warnings} |
| وضعیت امنیتی | {status_anti_link}, {status_anti_id}, و ... |
| 🆕 قیمت لحظهای بازار | {price_usd}, {price_gold_18k}, {price_coin_emami_market}, {price_bitcoin} |
| تاریخ و زمان | {date}, {time}, {weekday}, {message_time} |
| متادیتا | {bold:متن}, {italic:متن}, {link:متن:URL} |
| سرگرمی | {coin}, {joke}, {riddle}, {fortune} |
| دانستنیها | {motivation}, {fact}, {poem}, {wisdom} |
| ویژه | {user}, {duration}, {feature_name}, {feature_status} |
نکات مهم درباره تگها
• در پیامهای همگانی، فقط تگهای متادیتا (bold, italic, link و ...) کار میکنند
• تگهای داینامیک مثل
{name} در پیامهای همگانی کار نمیکنند (چون برای هر گیرنده متفاوت است)
• تگهای ریپلای مثل
{reply_mention} فقط وقتی کار میکنند که کاربر روی پیام دیگری ریپلای کرده باشد
مثال:
{bold:سلام {name}} باعث میشود هم نام جایگزین شود و هم متن bold باشد.
جدید قیمت لحظهای بازار
۱۹ تگ جدید برای نمایش خودکار قیمت دلار، طلا، سکه، ارز دیجیتال و نفت در پیامهای ربات.
لیست کامل ۱۹ تگ قیمت
ارزها
| تگ | توضیح |
|---|---|
{price_usd} | دلار آمریکا (آزاد) |
{price_euro} | یورو |
{price_gbp} | پوند انگلیس |
{price_aed} | درهم امارات |
{price_try} | لیر ترکیه |
{price_cny} | یوان چین |
طلا و نقره
| تگ | توضیح |
|---|---|
{price_gold_18k} | طلای ۱۸ عیار (هر گرم) |
{price_gold_24k} | طلای ۲۴ عیار (هر گرم) |
{price_gold_miskal} | مثقال طلا |
{price_gold_ounce} | انس جهانی طلا |
{price_silver_ounce} | انس جهانی نقره |
سکه
| تگ | توضیح |
|---|---|
{price_coin_emami} | سکه امامی (نرخ رسمی) |
{price_coin_emami_market} | سکه امامی (بازار آزاد) |
{price_coin_baharazadi_nim} | نیم سکه بهار آزادی |
{price_coin_baharazadi_rob} | ربع سکه بهار آزادی |
رمزارزها و انرژی
| تگ | توضیح |
|---|---|
{price_bitcoin} | بیتکوین |
{price_tether} | تتر (USDT) |
{price_ethereum} | اتریوم |
{price_brent} | نفت برنت |
نحوه استفاده
استفاده از این تگها بسیار ساده است. کافیست در متن پاسخ قابلیت، تگ مورد نظر را قرار دهید. ربات در زمان ارسال پیام، آن را با قیمت لحظهای جایگزین میکند.
قالب در پنل نوویکس:
محرک: قیمت دلار
پاسخ: 💵 قیمت دلار امروز: {price_usd}
خروجی ربات:
💵 قیمت دلار امروز: ۲۶۷٬۹۰۰ تومان
قالب در پنل نوویکس:
محرک: بازار
پاسخ:
💰 بازار لحظهای
💵 دلار: {price_usd}
🥇 طلای ۱۸: {price_gold_18k}
🪙 سکه امامی: {price_coin_emami_market}
🌍 انس طلا: {price_gold_ounce}
₿ بیتکوین: {price_bitcoin}
⏱️ بهروزرسانی خودکار از TGJU
خروجی ربات:
💰 بازار لحظهای
💵 دلار: ۲۶۷٬۹۰۰ تومان
🥇 طلای ۱۸: ۲۶٬۲۵۵٬۱۰۰ تومان
🪙 سکه امامی: ۲۶۹٬۹۲۰٬۰۰۰ تومان
🌍 انس طلا: ۱٬۱۱۳٬۴۴۸ تومان
₿ بیتکوین: ۲۱٬۹۰۸٬۲۰۱٬۰۰۰ تومان
⏱️ بهروزرسانی خودکار از TGJU
نکات فنی مهم
| موضوع | توضیح |
|---|---|
| منبع داده | TGJU.org (مرجع رسمی بازار طلا و ارز ایران) |
| بهروزرسانی | هر ۳۰ دقیقه توسط API PriceDB |
| کش داخلی | پاسخ API به مدت ۵ دقیقه کش میشود (برای جلوگیری از فشار به API) |
| واحد نمایش | تومان (قیمت API به ریال است و بر ۱۰ تقسیم میشود) |
| جداکننده | ٬ (U+066C) — جداکننده هزارگان فارسی |
| محل استفاده | در همه قابلیتها (شامل کلمه، دقیق، پاسخ تصادفی، کیبورد و ...) |
| خطا در دریافت | در صورت عدم دسترسی به API، مقدار نامشخص نمایش داده میشود |
• قیمت مثقال: هر مثقال (معادل ۴.۶۰۸۳ گرم)
• قیمت انس: هر اونس تروا (معادل ۳۱.۱۰۳۵ گرم)
• قیمت سکه: هر عدد سکه
سوالات متداول درباره تگهای قیمت
نامشخص نمایش داده میشود.
این رفتار باعث میشود پیام شما خراب نشود.
سیستم اخطار پیشرفته
مکانیزم اخطار و بن خودکار کاربران متخلف.
برای هر قابلیت امنیتی و همچنین warn_user، میتوانید حد نصاب اخطار تعیین کنید.
رفتار ربات در هر مقدار به این شکل است:
| حالت | رفتار ربات |
|---|---|
| ۰ (پیشفرض) | فقط حذف پیام + ارسال پیام اخطار. هیچ اخطاری ثبت نمیشود و کاربر بن نمیشود. |
| ۱ | بن فوری در اولین تخلف + پاک کردن کامل اطلاعات کاربر (اخطارها، رکورد کاربر، لاگ اسپم، سکوت). |
| ۲+ | هر تخلف یک اخطار اضافه میکند. با رسیدن به حد نصاب، کاربر به صورت خودکار بن میشود و اطلاعاتش پاک میشود. |
تگهای مفید برای نمایش اخطار
| تگ | کاربرد |
|---|---|
{warn_count} | تعداد اخطار فعلی کاربر در بخش جاری (مثلاً 2/5) |
{my_warnings} | لیست کامل اخطارهای فرستنده در همه بخشها |
{reply_warnings} | لیست اخطارهای کاربر ریپلایشده (نیاز به ریپلای) |
{group_warnings} | مجموع اخطارهای کل گروه + خلاصه آماری |
• مالک گروه — همیشه از تمام اخطارها و حذف پیام معاف است
• کاربران معاف (exempt) — کاربرانی که توسط مالک به لیست معافها اضافه شدهاند
• مالک و معافها از ضد اسپم هم معاف هستند
تنظیمات ضد لینک:
محرک: (خودکار)
محل اجرا: فقط گروه
متن اخطار: «❌ {mention} عزیز، ارسال لینک ممنوع است!
شما {warn_count} اخطار دارید.»
تعداد اخطار: ۳
نتیجه:
• تخلف ۱: پیام حذف، پیام اخطار ارسال (1/3)
• تخلف ۲: پیام حذف، پیام اخطار ارسال (2/3)
• تخلف ۳: پیام حذف، پیام اخطار ارسال (3/3) + کاربر بن میشود
قابلیتهای امنیتی (۱۲ قابلیت)
محافظت از گروه در برابر محتوای نامناسب. همه از سیستم اخطار پشتیبانی میکنند.
همه این قابلیتها در گروه فعال هستند و کاربر باید با ریپلای یا خودکار تشخیص داده شوند. برای تنظیم، کافیست روی هر کدام کلیک کنید و متن اخطار و تعداد اخطار را وارد کنید.
| قابلیت | توضیح |
|---|---|
| ضد لینک | حذف پیامهای حاوی لینک (URL، دامنه، آدرس وب) |
| ضد آیدی | حذف پیامهای حاوی آیدی (@username) |
| ضد فوروارد | حذف پیامهای فوروارد شده از گروه/کانال/کاربر دیگر |
| ضد اسپم | حذف پیامهای تکراری (۵ پیام یکسان در ۲۰ ثانیه) |
| ضد مدیا | حذف عکس، فیلم و گیف |
| ضد فایل | حذف فایل و سند (PDF، ZIP، Word و ...) |
| ضد ویرایش | حذف پیامهای ویرایش شده |
| ضد استیکر | حذف استیکرها |
| ضد لوکیشن | حذف موقعیت مکانی |
| ضد نظرسنجی | حذف نظرسنجیها |
| ضد هشتگ | حذف پیامهای حاوی هشتگ (#) |
| ضد کلمات ممنوع | حذف پیامهای حاوی کلمات ممنوعه (قابل تکرار - چند لیست مستقل) |
قابلیتهای مدیریتی (۱۵ قابلیت)
مدیریت کامل اعضای گروه با دستورات ساده.
اکثر قابلیتهای مدیریتی با ریپلای روی پیام کاربر انجام میشوند. برای هر قابلیت، باید یک متن محرک تعریف کنید که مدیر با ارسال آن روی پیام کاربر، عملیات را انجام دهد.
قابلیتهای مخصوص مالک گروه
| قابلیت | عملیات |
|---|---|
| افزودن مدیر | با ریپلای، کاربر به مدیران اضافه میشود |
| حذف مدیر | با ریپلای، کاربر از مدیران حذف میشود |
| پاک کردن لیست مدیران | تمام مدیران به یکباره حذف میشوند (بدون ریپلای) |
| انتقال مالکیت | مالکیت گروه به کاربر ریپلایشده منتقل میشود |
| معاف کردن کاربر | کاربر از اخطار و حذف پیام معاف میشود |
| لغو معافیت | کاربر از لیست معافها حذف میشود |
| پاک کردن لیست معافها | همه معافها حذف میشوند (بدون ریپلای) |
| پاک کردن لیست سکوت | همه ساکتها آزاد میشوند (بدون ریپلای) |
قابلیتهای مالک + مدیران
| قابلیت | عملیات |
|---|---|
| بن کاربر | با ریپلای، کاربر بن میشود |
| آن بن کاربر | با ریپلای، کاربر از بن خارج میشود |
| حذف پیام | با ریپلای، پیام کاربر حذف میشود |
| سکوت کاربر | با ریپلای + عدد (دقیقه)، کاربر ساکت میشود |
| رفع سکوت | با ریپلای، سکوت کاربر برداشته میشود |
| ثبت اخطار | با ریپلای، یک اخطار برای کاربر ثبت میشود |
| حذف اخطارها | با ریپلای، همه اخطارهای کاربر پاک میشود |
تنظیمات سکوت کاربر:
محرک: «سکوت»
محل اجرا: فقط گروه
متن پاسخ: «🔇 کاربر {user} به مدت {duration} دقیقه ساکت شد.»
نحوه استفاده در گروه:
• مدیر روی پیام کاربر ریپلای میکند
• دستور «سکوت ۳۰» را میفرستد (۳۰ = مدت به دقیقه)
• کاربر به مدت ۳۰ دقیقه ساکت میشود
• پیامهای کاربر ساکت به صورت خودکار حذف میشوند
• حداکثر مدت: ۱۴۴۰ دقیقه (یک روز)
• اگر عددی وارد نکنید، پیام راهنما نمایش داده میشود
• سکوتهای منقضی شده به صورت خودکار پاک میشوند
کنترل قابلیت (Toggle Feature)
روشن/خاموش کردن قابلیتهای امنیتی از داخل گروه.
با این قابلیت، میتوانید یک قابلیت امنیتی (مثل ضد لینک) را از داخل گروه روشن یا خاموش کنید، بدون اینکه نیاز باشد به پنل برگردید. این خیلی کاربردی است وقتی میخواهید برای مدتی قوانین سختگیرانهتر یا آزادتر اعمال کنید.
ساخت یک کنترل قابلیت
- در پنل، به بخش افزودن قابلیت بروید.
- کارت «کنترل قابلیت» را انتخاب کنید.
- قابلیت هدف را انتخاب کنید (مثلاً «ضد لینک»).
- متن محرک روشن کردن را وارد کنید (مثلاً «روشن کن»).
- متن پاسخ روشن کردن را وارد کنید (مثلاً «✅ ضد لینک فعال شد.»).
- متن محرک خاموش کردن را وارد کنید (مثلاً «خاموش کن»).
- متن پاسخ خاموش کردن را وارد کنید (مثلاً «⛔ ضد لینک غیرفعال شد.»).
- روی «ذخیره» کلیک کنید.
استفاده در گروه
پس از ساخت، مدیران گروه (و مالک) میتوانند با ارسال دستورات زیر، وضعیت را تغییر دهند:
- ارسال «روشن کن» در گروه → ضد لینک فعال میشود
- ارسال «خاموش کن» در گروه → ضد لینک غیرفعال میشود
وضعیت هر گروه جداگانه ذخیره میشود، یعنی ممکن است در گروه A ضد لینک فعال باشد و در گروه B غیرفعال.
{feature_name} (نام قابلیت هدف)
و {feature_status} (وضعیت فعلی) استفاده کنید.
تنظیمات ضروری @BotFather
برای کارکرد صحیح ربات در گروه، یک تنظیم حیاتی باید فعال شود.
مراحل فعالسازی
- وارد @BotFather در روبیکا شوید.
- گزینه «لیست رباتها» را انتخاب کنید.
- ربات مورد نظر خود را از لیست انتخاب کنید.
- روی گزینه «تنظیمات» کلیک کنید.
- گزینه «دریافت همهی پیامهای گروه و کانال» را فعال کنید (وضعیت آن باید تغییر کند).
چرا این تنظیم ضروری است؟
برای کارکرد صحیح این قابلیتها ضروری است:
| قابلیتهای امنیتی | قابلیتهای پاسخ خودکار |
|---|---|
| ضد لینک، ضد آیدی، ضد کلمات ممنوع، ضد اسپم | شامل کلمه، دقیق، پاسخ تصادفی |
| ضد مدیا، ضد فایل، ضد استیکر | آمار گروه، ثبت اخطار |
| ضد ویرایش، ضد لوکیشن، ضد نظرسنجی، ضد هشتگ | ضد فوروارد |
تفاوت کاربران عادی و VIP
چه امکاناتی فقط برای کاربران VIP در دسترس است.
| امکان | عادی | VIP |
|---|---|---|
| ساخت ربات | ✅ | ✅ |
| همه قابلیتهای پایه | ✅ | ✅ |
| ۱۹ تگ قیمت لحظهای بازار | ✅ | ✅ |
| کیبورد مرحلهای | ۱ مرحله | ۵ مرحله |
| قابلیت پشتیبانی (support) | ❌ | ✅ |
| مدیریت گروههای فعال | ❌ | ✅ |
| مشاهده تیکتهای پشتیبانی | ❌ | ✅ |
| تعیین گروه VIP (حذف از ارسال همگانی) | ❌ | ✅ |
| ارسال همگانی زمانبندی شده | ✅ | ✅ |
آزمایش و عیبیابی
چطور مطمئن شوید ربات درست کار میکند و اگر مشکل بود، چطور رفعش کنید.
مراحل آزمایش ربات
- ربات را در یک گروه آزمایشی (یا پی وی خودتان) فعال کنید.
- دستور «فعال» را در گروه بفرستید تا مالک گروه شوید.
- متن محرک یکی از قابلیتهای فعال را در چت ارسال کنید.
- پاسخ ربات را بررسی کنید.
- اگر پاسخ نگرفتید، به ترتیب مراحل زیر را بررسی کنید.
مشکلات رایج و راهحلها
| مشکل | راهحل |
|---|---|
| ربات به هیچ پیامی در گروه پاسخ نمیدهد | تنظیم «دریافت همه پیامها» را در @BotFather فعال کنید (بخش ۱۶). |
| ربات فقط به ریپلای پاسخ میدهد | همان مشکل بالا؛ تنظیم @BotFather را فعال کنید. |
| قابلیت به درستی اجرا نمیشود | مطمئن شوید قابلیت فعال است و متن محرک دقیقاً همان چیزی است که فرستادید. |
| تگها به جای متن جایگزین نمیشوند | مطمئن شوید تگ را دقیقاً با همان سینتکس نوشتهاید (مثلاً {name} با آکولاد). |
| ربات هیچ عکس العملی نشان نمیدهد | توکن ربات را بررسی کنید. اگر invalid شده، از پنل، توکن جدید ثبت کنید. |
| دکمهها در گروه نمایش داده نمیشوند | کیبورد فقط در پی وی نمایش داده میشود. مطمئن شوید قابلیت کیبورد را ساخته و در پی وی آزمایش میکنید. |
| پاسخ ربات به صورت ریپلای نیست | در تنظیمات قابلیت، «حالت ارسال پاسخ» را روی ریپلای تنظیم کنید. |
| پیام کاربر معاف هم حذف میشود | مطمئن شوید که کاربر در لیست معافها هست. برای تأیید، از تگ {exempts} استفاده کنید. |
| سکوت کاربر اعمال نمیشود | ربات باید اجازه حذف پیام داشته باشد. در تنظیمات گروه، ربات را admin کنید. |
| ترتیب اجرای قابلیتها اشتباه است | از بخش «ویرایش قابلیت»، اولویت را تغییر دهید (عدد کوچکتر = اولویت بالاتر). |
| 🆕 قیمتها به جای عدد، «نامشخص» نشان میدهند | ممکن است API در آن لحظه در دسترس نباشد. چند دقیقه بعد دوباره تلاش کنید. |
| 🆕 قیمتها بهروز نیستند | قیمتها هر ۳۰ دقیقه بهروزرسانی میشوند. کش داخلی ۵ دقیقه است. حداکثر تأخیر ۳۵ دقیقه است. |
مثالهای عملی
چند سناریوی واقعی برای الگوگیری در ساخت قابلیتها.
نوع قابلیت: شامل کلمه
محرک اصلی: سلام
محرکهای اضافی: درود، های، سلام علیکم
محل اجرا: همه جا
حالت ارسال: عادی
متن پاسخ: سلام {name} عزیز! چطور میتوانم کمک کنم؟
نوع پیوست: بدون فایل
نتیجه: کاربر با هر یک از این کلمات، پاسخ شخصیسازیشده دریافت میکند.
نوع قابلیت: ضد لینک (یک بار مصرف)
محل اجرا: فقط گروه
متن اخطار: ❌ {mention} عزیز، ارسال لینک ممنوع است!
تعداد اخطار: 3
نتیجه:
• تخلف ۱: پیام حذف، اخطار (1/3)
• تخلف ۲: پیام حذف، اخطار (2/3)
• تخلف ۳: پیام حذف، اخطار (3/3) + بن خودکار
مرحله ۱: کیبورد اصلی ┌─ 📞 اطلاعات (ردیف ۱) └─ 📖 راهنما (ردیف ۱) مرحله ۲: زیرکیبورد «اطلاعات» ┌─ درباره ما | خدمات (ردیف ۱) └─ 🔙 بازگشت (ردیف ۲) مرحله ۳: زیرکیبورد «درباره ما» ┌─ ما یک تیم حرفهای هستیم... └─ 🔙 بازگشت (ردیف ۱) نتیجه: کاربر میتواند بین منوها جابهجا شود.
نوع قابلیت: کنترل قابلیت (toggle_feature) قابلیت هدف: ضد لینک متن محرک روشن: روشن کن متن پاسخ روشن: ✅ ضد لینک فعال شد. متن محرک خاموش: خاموش کن متن پاسخ خاموش: ⛔ ضد لینک غیرفعال شد. نحوه استفاده در گروه: • مدیر: «روشن کن» → ضد لینک فعال میشود • مدیر: «خاموش کن» → ضد لینک غیرفعال میشود
نوع قابلیت: ثبت اخطار (warn_user)
محرک: اخطار
محل اجرا: فقط گروه
حداکثر اخطار: 5
متن پاسخ: ⚠️ کاربر {mention} اخطار دریافت کرد. ({warn_count})
نحوه استفاده در گروه:
• مدیر روی پیام کاربر ریپلای میکند
• دستور «اخطار» را میفرستد
• اخطار ثبت میشود
• اگر به ۵ اخطار برسد، کاربر بن میشود
نوع قابلیت: دقیق
محرک: قیمتها
محل اجرا: همه جا
متن پاسخ:
💰 قیمت لحظهای بازار
💵 دلار: {price_usd}
💶 یورو: {price_euro}
🥇 طلای ۱۸: {price_gold_18k}
🪙 سکه امامی: {price_coin_emami_market}
🌍 انس طلا: {price_gold_ounce}
₿ بیتکوین: {price_bitcoin}
⏱️ بهروزرسانی خودکار
خروجی ربات:
💰 قیمت لحظهای بازار
💵 دلار: ۲۶۷٬۹۰۰ تومان
💶 یورو: ۲۹۱٬۵۰۰ تومان
🥇 طلای ۱۸: ۲۶٬۲۵۵٬۱۰۰ تومان
🪙 سکه امامی: ۲۶۹٬۹۲۰٬۰۰۰ تومان
🌍 انس طلا: ۱٬۱۱۳٬۴۴۸ تومان
₿ بیتکوین: ۲۱٬۹۰۸٬۲۰۱٬۰۰۰ تومان
⏱️ بهروزرسانی خودکار
سوالات متداول
پاسخ به پرسشهای پرتکرار کاربران.
@BotFather نیاز دارید.
هیچ هزینهای برای سرور، دامنه یا نگهداری پرداخت نمیکنید.
کاربران VIP: تا ۵ مرحله زیرکیبورد.
{mention} — منشن خودِ کاربر (فرستنده پیام)
•
{reply_mention} — منشن کاربری که روی پیامش ریپلای شده
•
{owner} — منشن مالک گروه
برای معاف کردن، روی پیام کاربر ریپلای کنید و دستور معاف را بفرستید.
2. گزینه «افزودن عضو» را انتخاب کنید.
3. یوزرنیم ربات (مثلاً
@my_bot) را جستجو کنید.
4. ربات را اضافه کنید و به عنوان admin تنظیم کنید.
5. دستور «فعال» را در گروه بفرستید تا ربات فعال شود و شما مالک گروه شوید.
{price_usd}، برای طلای ۱۸ از
{price_gold_18k}، برای سکه امامی از {price_coin_emami_market}.
قیمتها خودکار از TGJU دریافت میشوند و به تومان نمایش داده میشوند.
جزئیات کامل در بخش ۱۱ همین راهنما.