📖 راهنما

راهنمای ربات‌ساز نوویکس

آموزش کامل و جامع ساخت و مدیریت ربات با ربات‌ساز

حداقل ۲ کاراکتر وارد کنید تا دستورات مرتبط نمایش داده شوند

ساخت ربات با ربات‌ساز نوویکس

برای ساخت ربات، ابتدا باید یک توکن از ربات @BotFather در روبیکا دریافت کنید.

مراحل دریافت توکن:
۱. ربات @BotFather را در روبیکا پیدا کنید و استارت کنید.
۲. بر روی دکمه بات جدید کلیک کنید.
۳. نام ربات خود را وارد کنید (مثلاً: «ربات گروه من»).
۴. نام کاربری ربات را وارد کنید (باید به bot ختم شود، مثلاً: «my_group_bot»).
۵. پس از تأیید، توکن ربات به شما نمایش داده می‌شود.

نکته مهم: توکن را در جای امنی ذخیره کنید. هر کسی که توکن شما را داشته باشد، می‌تواند ربات شما را کنترل کند.

🔗 لینک مستقیم به @BotFather
پس از دریافت توکن، مراحل زیر را برای ثبت ربات در ربات‌ساز نوویکس انجام دهید:

۱. ورود به حساب کاربری:
ابتدا در وب‌سایت ربات‌ساز وارد حساب کاربری خود شوید. اگر حساب ندارید، ثبت‌نام کنید.

۲. رفتن به بخش ساخت ربات:
روی دکمه ساخت ربات جدید در داشبورد کلیک کنید یا به آدرس زیر بروید:
/builder/create/

۳. وارد کردن توکن:
توکن دریافتی از @BotFather را در فیلد مربوطه وارد کنید. سیستم به صورت خودکار توکن را بررسی می‌کند و در صورت معتبر بودن، اطلاعات ربات را نمایش می‌دهد.

۴. کلیک روی دکمه ساخت:
پس از تأیید توکن، روی دکمه ساخت ربات کلیک کنید. ربات شما در کمتر از ۱ دقیقه ساخته می‌شود و وب‌هوک آن به صورت خودکار تنظیم می‌گردد.

نکته: هر توکن فقط یک بار قابل ثبت است. اگر توکن قبلاً ثبت شده باشد، سیستم به شما اطلاع می‌دهد.
پس از ساخت ربات، می‌توانید قابلیت‌های مختلفی به آن اضافه کنید. برای این کار:

۱. رفتن به صفحه جزئیات ربات:
در داشبورد، روی نام ربات خود کلیک کنید تا وارد صفحه جزئیات شوید.

۲. کلیک روی دکمه افزودن قابلیت:
در صفحه جزئیات، روی دکمه افزودن قابلیت کلیک کنید.

۳. انتخاب نوع قابلیت:
دو نوع قابلیت وجود دارد: یک بار مصرف (تکی) و چندگانه (قابل تکرار).

📌 قابلیت‌های یک بار مصرف (تکی):
پیام شروع (/start) - پیام خوش‌آمدگویی هنگام استارت ربات (فقط پی وی)
پیام راهنما (/help) - راهنمای کامل ربات (فقط پی وی)
پیام فعال‌سازی (فقط گروه) - متن دلخواه پس از فعال‌سازی ربات در گروه
افزودن مدیر (با ریپلای - فقط گروه) - افزودن کاربر به عنوان مدیر
حذف مدیر (با ریپلای - فقط گروه) - حذف کاربر از مدیران
لیست مدیران (فقط گروه) - نمایش لیست مدیران گروه
بن کاربر (با ریپلای - فقط گروه) - بن کردن کاربر
آن بن کاربر (با ریپلای - فقط گروه) - رفع بن کاربر
حذف پیام (با ریپلای - فقط گروه - مالک و مدیران) - حذف پیام مورد نظر

📌 قابلیت‌های امنیتی (یک بار مصرف - فقط گروه):
ضد لینک - جلوگیری از ارسال لینک
ضد آیدی - جلوگیری از ارسال آیدی
ضد کلمات ممنوع - جلوگیری از ارسال کلمات ممنوع

📌 قابلیت‌های ویژه (نیاز به اشتراک VIP):
انتقال مالکیت (با ریپلای - فقط گروه - مالک) - انتقال مالکیت گروه به کاربر دیگر
سکوت کاربر (با ریپلای - فقط گروه) - ساکت کردن کاربر به مدت مشخص یا دائمی
رفع سکوت کاربر (با ریپلای - فقط گروه) - رفع سکوت کاربر
پشتیبانی (فقط پی وی) - ارسال تیکت پشتیبانی به ادمین

📌 قابلیت‌های چندگانه (قابل تکرار):
شامل کلمه - پاسخ به پیام‌هایی که شامل کلمه مشخصی هستند
دقیق - پاسخ به پیام‌هایی که دقیقاً برابر با متن مشخصی هستند
پاسخ تصادفی - انتخاب تصادفی از لیست پاسخ‌ها
کیبورد شیشه‌ای (Chat Keyboard) - دکمه‌های پایین صفحه چت (فقط پی وی)
کیبورد درون پیام (Inline Keyboard) - دکمه‌های داخل پیام با ویرایش (فقط پی وی)

۴. تنظیم محل اجرا:
برای هر قابلیت می‌توانید مشخص کنید که در کجا اجرا شود:
همه جا - در پی وی، گروه و کانال
فقط پی وی - فقط در مکالمات خصوصی
فقط گروه - فقط در گروه‌ها
فقط کانال - فقط در کانال‌ها

۵. تنظیم حالت ارسال پاسخ:
ارسال عادی - پیام به صورت معمولی ارسال می‌شود
ریپلای روی پیام - پاسخ روی پیام کاربر ریپلای می‌شود

۶. افزودن فایل (اختیاری):
می‌توانید یک فایل آیدی (عکس، ویدئو، صوت، فایل و ...) به قابلیت اضافه کنید.

۷. ذخیره قابلیت:
پس از تکمیل اطلاعات، روی دکمه ذخیره قابلیت کلیک کنید.
پس از ساخت ربات و افزودن قابلیت‌ها، ربات شما به صورت خودکار فعال می‌شود. اما برای مدیریت ربات خود، امکانات زیر در اختیار شماست:

🔄 فعال/غیرفعال کردن ربات:
در صفحه جزئیات ربات، با کلیک روی دکمه فعال/غیرفعال می‌توانید ربات را روشن یا خاموش کنید. در حالت غیرفعال، ربات به پیام‌ها پاسخ نمی‌دهد.

📋 مدیریت قابلیت‌ها:
در صفحه جزئیات ربات، لیست تمام قابلیت‌های ربات را مشاهده می‌کنید. برای هر قابلیت می‌توانید:
• آن را ویرایش کنید
• آن را فعال/غیرفعال کنید
• آن را حذف کنید

📂 مدیریت فایل‌ها:
با استفاده از بخش مدیریت فایل‌ها می‌توانید فایل‌های خود را آپلود کنید و فایل‌آیدی آنها را برای استفاده در قابلیت‌ها کپی کنید.

📨 مشاهده آپدیت‌ها:
با کلیک روی دکمه آپدیت‌ها، می‌توانید تمام پیام‌های دریافتی ربات را مشاهده کنید. این قابلیت به شما کمک می‌کند تا عملکرد ربات را بررسی کنید.

📢 ارسال پیام همگانی:
با استفاده از بخش ارسال پیام به همه کاربران و ارسال پیام به گروه‌ها می‌توانید پیام‌های همگانی ارسال کنید.

🗑️ حذف ربات:
اگر دیگر به ربات نیاز ندارید، می‌توانید آن را به همراه تمام قابلیت‌ها و آپدیت‌ها حذف کنید. این عمل غیرقابل بازگشت است.

انواع قابلیت‌های ربات

توضیح: این قابلیت زمانی اجرا می‌شود که کاربر برای اولین بار ربات را استارت کند یا دستور /start را ارسال کند.

کاربرد: ارسال پیام خوش‌آمدگویی، معرفی ربات و راهنمای اولیه به کاربران جدید.

محل اجرا: فقط پی وی

امکانات ویژه: می‌توانید همراه با این قابلیت فایل ارسال کنید، کیبورد شیشه‌ای یا کیبورد درون پیام نمایش دهید.

مثال:
متن پاسخ: «به ربات خوش آمدید! برای مشاهده راهنما /help را ارسال کنید.»
توضیح: این قابلیت زمانی اجرا می‌شود که کاربر دستور /help را ارسال کند.

کاربرد: نمایش راهنمای کامل ربات، لیست دستورات و توضیحات هر یک به کاربران.

محل اجرا: فقط پی وی

امکانات ویژه: می‌توانید همراه با این قابلیت فایل ارسال کنید.

مثال:
متن پاسخ: «راهنمای ربات: /start - شروع مجدد، /help - نمایش راهنما، ...»
توضیح: این قابلیت پس از ارسال دستور فعال در گروه، یک پیام دلخواه ارسال می‌کند.

کاربرد: ارسال پیام خوش‌آمدگویی، معرفی ربات و راهنمای اولیه به اعضای گروه.

محل اجرا: فقط گروه

نحوه کار:
۱. کاربر دستور فعال را در گروه ارسال می‌کند.
۲. ربات پیام فعال‌سازی را ارسال می‌کند.
۳. گروه به لیست گروه‌های فعال ربات اضافه می‌شود.

مثال:
متن پیام: «🎉 ربات در گروه شما فعال شد! برای مشاهده راهنما دستور راهنما را ارسال کنید.»
توضیح: با ریپلای روی پیام کاربر و ارسال متن محرک، کاربر به عنوان مدیر گروه اضافه می‌شود.

کاربرد: مدیریت سریع و آسان مدیران گروه.

محل اجرا: فقط گروه

دسترسی: فقط مالک

نحوه کار:
۱. روی پیام کاربر مورد نظر ریپلای کنید.
۲. متن محرک تنظیم‌شده را ارسال کنید (مثلاً: «مدیر»).
۳. ربات کاربر را به مدیران گروه اضافه می‌کند.

مثال:
متن محرک: «مدیر»
متن پاسخ: «👑 کاربر با موفقیت به عنوان مدیر گروه اضافه شد!»
توضیح: با ریپلای روی پیام کاربر و ارسال متن محرک، کاربر از مدیران گروه حذف می‌شود.

کاربرد: مدیریت سریع و آسان مدیران گروه.

محل اجرا: فقط گروه

دسترسی: فقط مالک

نحوه کار:
۱. روی پیام کاربر مورد نظر ریپلای کنید.
۲. متن محرک تنظیم‌شده را ارسال کنید (مثلاً: «حذف مدیر»).
۳. ربات کاربر را از مدیران گروه حذف می‌کند.

مثال:
متن محرک: «حذف مدیر»
متن پاسخ: «👑 کاربر از مدیران گروه حذف شد!»
توضیح: با ارسال متن محرک، لیست کامل مدیران گروه نمایش داده می‌شود.

کاربرد: مشاهده سریع لیست مدیران گروه.

محل اجرا: فقط گروه

دسترسی: همه کاربران

نحوه کار:
۱. متن محرک تنظیم‌شده را در گروه ارسال کنید (مثلاً: «لیست مدیران»).
۲. ربات لیست کامل مدیران را نمایش می‌دهد.

مثال:
متن محرک: «لیست مدیران»
متن پاسخ: «📋 لیست مدیران گروه: ...»
توضیح: با ریپلای روی پیام کاربر و ارسال متن محرک، کاربر از گروه بن می‌شود.

کاربرد: مدیریت سریع کاربران مزاحم.

محل اجرا: فقط گروه

دسترسی: فقط مالک و مدیران

نحوه کار:
۱. روی پیام کاربر مورد نظر ریپلای کنید.
۲. متن محرک تنظیم‌شده را ارسال کنید (مثلاً: «بن»).
۳. ربات کاربر را از گروه بن می‌کند.

مثال:
متن محرک: «بن»
متن پاسخ: «🚫 کاربر با موفقیت از گروه بن شد!»
توضیح: با ریپلای روی پیام کاربر و ارسال متن محرک، کاربر از حالت بن خارج می‌شود.

کاربرد: رفع بن کاربران.

محل اجرا: فقط گروه

دسترسی: فقط مالک و مدیران

نحوه کار:
۱. روی پیام کاربر مورد نظر ریپلای کنید.
۲. متن محرک تنظیم‌شده را ارسال کنید (مثلاً: «آن بن»).
۳. ربات کاربر را از حالت بن خارج می‌کند.

مثال:
متن محرک: «آن بن»
متن پاسخ: «✅ کاربر با موفقیت از بن خارج شد!»
توضیح: با ریپلای روی پیام و ارسال متن محرک، پیام مورد نظر حذف می‌شود.

کاربرد: حذف پیام‌های نامناسب یا اسپم.

محل اجرا: فقط گروه

دسترسی: فقط مالک و مدیران

نحوه کار:
۱. روی پیام مورد نظر ریپلای کنید.
۲. متن محرک تنظیم‌شده را ارسال کنید (مثلاً: «پاک کن»).
۳. ربات پیام را حذف می‌کند.

مثال:
متن محرک: «پاک کن»
متن پاسخ: «🗑️ پیام با موفقیت حذف شد!»
توضیح: این قابلیت از ارسال لینک در گروه جلوگیری می‌کند.

کاربرد: جلوگیری از هرزنامه و تبلیغات در گروه.

محل اجرا: فقط گروه

نحوه کار:
۱. کاربر لینکی در گروه ارسال می‌کند.
۲. ربات پیام را حذف می‌کند.
۳. ربات متن اخطار را ارسال می‌کند.

مثال:
متن اخطار: «❌ ارسال لینک در این گروه ممنوع است!»
توضیح: این قابلیت از ارسال آیدی (با @) در گروه جلوگیری می‌کند.

کاربرد: جلوگیری از تبلیغات و معرفی کاربران دیگر.

محل اجرا: فقط گروه

نحوه کار:
۱. کاربر آیدی (مثلاً @username) در گروه ارسال می‌کند.
۲. ربات پیام را حذف می‌کند.
۳. ربات متن اخطار را ارسال می‌کند.

مثال:
متن اخطار: «❌ ارسال آیدی در این گروه ممنوع است!»
توضیح: این قابلیت از ارسال کلمات ممنوع در گروه جلوگیری می‌کند.

کاربرد: جلوگیری از کلمات نامناسب و توهین‌آمیز در گروه.

محل اجرا: فقط گروه

نحوه کار:
۱. کاربر کلمه ممنوعی در گروه ارسال می‌کند.
۲. ربات پیام را حذف می‌کند.
۳. ربات متن اخطار را ارسال می‌کند.

مثال:
لیست کلمات ممنوع: «بد» - «بی‌ادب» - «توهین»
متن اخطار: «❌ ارسال کلمات ممنوع در این گروه ممنوع است!»
توضیح: با ریپلای روی پیام کاربر و ارسال متن محرک، مالکیت گروه به کاربر مورد نظر منتقل می‌شود.

کاربرد: انتقال مالکیت گروه به کاربر دیگر.

محل اجرا: فقط گروه

دسترسی: فقط مالک فعلی

VIP

نحوه کار:
۱. روی پیام کاربر مورد نظر ریپلای کنید.
۲. متن محرک تنظیم‌شده را ارسال کنید (مثلاً: «انتقال مالکیت»).
۳. ربات مالکیت گروه را به کاربر جدید منتقل می‌کند.

مثال:
متن محرک: «انتقال مالکیت»
متن پاسخ: «✅ مالکیت گروه با موفقیت منتقل شد!»
توضیح: با ریپلای روی پیام کاربر و ارسال متن محرک (همراه با عدد اختیاری برای دقیقه)، کاربر به مدت مشخص ساکت می‌شود.

کاربرد: مدیریت سریع کاربران مزاحم.

محل اجرا: فقط گروه

دسترسی: فقط مدیران

VIP

نحوه کار:
۱. روی پیام کاربر مورد نظر ریپلای کنید.
۲. متن محرک تنظیم‌شده را ارسال کنید (مثلاً: «سکوت ۳۰» برای ۳۰ دقیقه). اگر عددی نباشد، سکوت دائمی خواهد بود.
۳. ربات کاربر را ساکت می‌کند.

مثال:
متن محرک: «سکوت ۳۰»
متن پاسخ: «🔇 کاربر به مدت ۳۰ دقیقه ساکت شد!»
توضیح: با ریپلای روی پیام کاربر و ارسال متن محرک، سکوت کاربر برداشته می‌شود.

کاربرد: رفع سکوت کاربران.

محل اجرا: فقط گروه

دسترسی: فقط مدیران

VIP

نحوه کار:
۱. روی پیام کاربر مورد نظر ریپلای کنید.
۲. متن محرک تنظیم‌شده را ارسال کنید (مثلاً: «رفع سکوت»).
۳. ربات سکوت کاربر را برمی‌دارد.

مثال:
متن محرک: «رفع سکوت»
متن پاسخ: «🔊 سکوت کاربر با موفقیت برداشته شد!»
توضیح: با ارسال متن محرک (یا کلیک روی دکمه کیبورد)، کاربر می‌تواند پیام خود را به عنوان تیکت پشتیبانی به ادمین ارسال کند.

کاربرد: ایجاد ارتباط مستقیم با پشتیبانی ربات.

محل اجرا: فقط پی وی

VIP

نحوه کار:
۱. کاربر متن محرک تنظیم‌شده را ارسال می‌کند (مثلاً: «پشتیبانی»).
۲. ربات پیام خوش‌آمدگویی ارسال می‌کند.
۳. کاربر پیام خود را ارسال می‌کند.
۴. ربات پیام را به عنوان تیکت ذخیره می‌کند و به ادمین اطلاع می‌دهد.

مثال:
متن محرک: «پشتیبانی»
متن پاسخ: «💬 لطفاً پیام خود را ارسال کنید...»
توضیح: اگر پیام کاربر شامل کلمه یا عبارت مشخصی باشد، ربات پاسخ مورد نظر را ارسال می‌کند.

کاربرد: پاسخ به سوالات متداول، ارائه اطلاعات خاص در پاسخ به کلمات کلیدی، ایجاد تعامل با کاربران.

محل اجرا: قابل تنظیم در همه جا، پی وی، گروه یا کانال

امکانات ویژه: می‌توانید همراه با این قابلیت فایل ارسال کنید و از دستورات پویا استفاده کنید.

مثال:
کلمه محرک: «سلام»
متن پاسخ: «سلام عزیزم! چطور می‌توانم کمک کنم؟»
توضیح: اگر پیام کاربر دقیقاً برابر با متن مشخصی باشد، ربات پاسخ مورد نظر را ارسال می‌کند.

کاربرد: پاسخ به دستورات خاص، ایجاد منوی متنی با گزینه‌های مشخص، ارائه اطلاعات دقیق.

محل اجرا: قابل تنظیم در همه جا، پی وی، گروه یا کانال

امکانات ویژه: می‌توانید همراه با این قابلیت فایل ارسال کنید و از دستورات پویا استفاده کنید.

مثال:
متن دقیق: «قیمت»
متن پاسخ: «قیمت محصولات ما از ۱۰۰,۰۰۰ تومان شروع می‌شود.»
توضیح: اگر پیام کاربر شامل کلمه یا عبارت مشخصی باشد، ربات یکی از پاسخ‌های موجود در لیست را به صورت تصادفی انتخاب و ارسال می‌کند.

کاربرد: ایجاد تنوع در پاسخ‌ها، جذابیت بیشتر برای کاربران، پاسخ‌های خلاقانه و غیرتکراری.

محل اجرا: قابل تنظیم در همه جا، پی وی، گروه یا کانال

امکانات ویژه: می‌توانید همراه با این قابلیت فایل ارسال کنید و از دستورات پویا استفاده کنید.

مثال:
کلمه محرک: «اوضاع»
لیست پاسخ‌ها: «خوبم ممنون» - «عالی هستم» - «خوب و خوش»
هر بار یکی از این پاسخ‌ها به صورت تصادفی ارسال می‌شود.
توضیح: این قابلیت دکمه‌هایی را در پایین صفحه چت نمایش می‌دهد. کاربر با کلیک روی هر دکمه، پاسخ مربوطه را دریافت می‌کند.

کاربرد: ایجاد منوی تعاملی، راهنمای سریع، دسترسی آسان به اطلاعات.

محل اجرا: فقط پی وی

امکانات ویژه: می‌توانید همراه با این قابلیت فایل ارسال کنید.

نحوه کار:
۱. دکمه‌ها به صورت ردیفی در پایین صفحه چت نمایش داده می‌شوند.
۲. کاربر با کلیک روی هر دکمه، یک پیام جدید با متن دکمه ارسال می‌کند.
۳. ربات پاسخ مربوط به آن دکمه را ارسال می‌کند.

مثال:
دکمه‌ها: «اطلاعات» - «راهنما» - «تماس با ما»
پاسخ هر دکمه: اطلاعات مربوط به آن دکمه
توضیح: این قابلیت دکمه‌هایی را در داخل پیام نمایش می‌دهد. با کلیک روی هر دکمه، متن پیام به پاسخ مربوطه ویرایش می‌شود.

کاربرد: ایجاد منوهای تعاملی، فرم‌های ساده، انتخاب گزینه‌ها.

محل اجرا: فقط پی وی

امکانات ویژه: می‌توانید همراه با این قابلیت فایل ارسال کنید.

نحوه کار:
۱. یک پیام با دکمه‌های زیر آن ارسال می‌شود.
۲. کاربر روی یکی از دکمه‌ها کلیک می‌کند.
۳. متن همان پیام به پاسخ مربوطه ویرایش می‌شود.

مثال:
پیام: «لطفاً یکی از گزینه‌ها را انتخاب کنید:»
دکمه‌ها: «گزینه ۱» - «گزینه ۲» - «گزینه ۳»
با کلیک روی هر دکمه، پیام به پاسخ مربوطه تغییر می‌کند.

تنظیمات و شخصی‌سازی

یکی از ویژگی‌های قدرتمند ربات‌ساز نوویکس، امکان تنظیم محل اجرای هر قابلیت است.

شما می‌توانید برای هر قابلیت مشخص کنید که در کدام نوع چت اجرا شود:

🌍 همه جا (All):
قابلیت در تمام انواع چت‌ها (پی وی، گروه و کانال) اجرا می‌شود. مناسب برای قابلیت‌های عمومی که همه کاربران باید به آنها دسترسی داشته باشند.

👤 پی وی (Private):
قابلیت فقط در مکالمات خصوصی با ربات اجرا می‌شود. مناسب برای قابلیت‌های شخصی مانند استارت، راهنما، کیبورد شیشه‌ای و کیبورد درون پیام.

👥 گروه (Group):
قابلیت فقط در گروه‌ها اجرا می‌شود. مناسب برای قابلیت‌های گروهی مانند مدیریت گروه و پاسخ به سوالات گروهی. قابلیت‌های ضد لینک، ضد آیدی، ضد کلمات ممنوع و پیام فعال‌سازی فقط در گروه اجرا می‌شوند.

📢 کانال (Channel):
قابلیت فقط در کانال‌ها اجرا می‌شود. مناسب برای قابلیت‌های مربوط به کانال‌ها مانند ارسال خودکار و پاسخ به نظرات.

نکته: قابلیت‌های استارت، راهنما، کیبورد شیشه‌ای و کیبورد درون پیام به صورت پیش‌فرض فقط در پی وی اجرا می‌شوند و قابل تغییر نیستند. قابلیت‌های ضد لینک، ضد آیدی، ضد کلمات ممنوع و پیام فعال‌سازی فقط در گروه اجرا می‌شوند و قابل تغییر نیستند.
شما می‌توانید مشخص کنید که پاسخ ربات به صورت عادی ارسال شود یا روی پیام کاربر ریپلای شود.

📨 ارسال عادی (Normal):
پاسخ به صورت یک پیام جدید در چت ارسال می‌شود.

↩️ ریپلای روی پیام (Reply):
پاسخ به صورت ریپلای روی پیام کاربر ارسال می‌شود. این حالت برای پاسخ به سوالات خاص و مکالمات منظم مفید است.
ربات‌ساز نوویکس از ارسال فایل همراه با پیام پشتیبانی می‌کند.

📤 نحوه کار:
۱. فایل خود را در بخش مدیریت فایل‌ها آپلود کنید.
۲. فایل‌آیدی دریافتی را در قابلیت مورد نظر وارد کنید.
۳. اگر متن پاسخ وجود داشته باشد، فایل همراه با متن ارسال می‌شود.
۴. اگر متن پاسخ خالی باشد، فقط فایل ارسال می‌شود.

📂 انواع فایل‌های قابل ارسال:
• عکس (Image) - jpg, png, gif, webp (حداکثر ۱۰ مگابایت)
• ویدئو (Video) - mp4 (حداکثر ۵۰ مگابایت)
• صوت (Audio) - mp3
• فایل (Document) - انواع فایل‌ها (حداکثر ۵۰ مگابایت)
• گیف (Gif) - mp4 بدون صدا
• استیکر (Sticker)
اولویت قابلیت‌ها مشخص می‌کند که در صورت تطابق چند قابلیت با یک پیام، کدام یک اولویت بیشتری دارد.

قابلیت‌ها به صورت خودکار بر اساس ترتیب افزودن اولویت‌بندی می‌شوند. قابلیت‌های جدیدتر اولویت بالاتری دارند.

همچنین می‌توانید در زمان ویرایش قابلیت، اولویت آن را تغییر دهید.

مثال:
اگر دو قابلیت «شامل کلمه» با کلمات «سلام» و «سلام عزیز» داشته باشید:
• قابلیت اول: کلمه «سلام» - اولویت ۱
• قابلیت دوم: کلمه «سلام عزیز» - اولویت ۲

اگر کاربر پیام «سلام عزیز» را ارسال کند، قابلیت دوم (با اولویت بالاتر) اجرا می‌شود.
هر قابلیت را می‌توانید به صورت جداگانه فعال یا غیرفعال کنید.

این ویژگی به شما امکان می‌دهد تا بدون حذف قابلیت‌ها، آنها را به طور موقت غیرفعال کنید.

کاربردها:
• تست قابلیت‌های جدید: قبل از فعال‌سازی کامل، آن را تست کنید
• غیرفعال کردن موقت: در صورت بروز مشکل، قابلیت را غیرفعال کنید
• مدیریت فصلی: برخی قابلیت‌ها را در زمان‌های خاص فعال کنید

نحوه انجام:
در صفحه جزئیات ربات، در کنار هر قابلیت، دکمه فعال/غیرفعال قرار دارد. با کلیک روی آن، وضعیت قابلیت تغییر می‌کند.

مدیریت ربات‌ها

داشبورد ربات‌ها، مرکز مدیریت تمام ربات‌های شماست.

در این صفحه، لیست تمام ربات‌هایی که ساخته‌اید را مشاهده می‌کنید. برای هر ربات اطلاعات زیر نمایش داده می‌شود:

نام ربات - نامی که برای ربات انتخاب کرده‌اید
نام کاربری - نام کاربری ربات در روبیکا
وضعیت - فعال یا غیرفعال بودن ربات
تعداد کاربران - تعداد کاربرانی که با ربات در ارتباط بوده‌اند
گروه‌های فعال - تعداد گروه‌هایی که ربات را فعال کرده‌اند

اقدامات قابل انجام در داشبورد:
مشاهده جزئیات - رفتن به صفحه مدیریت ربات
ساخت ربات جدید - ساخت ربات جدید با توکن جدید
حذف ربات - حذف کامل ربات و تمام اطلاعات آن
قسمت آپدیت‌ها، تمام پیام‌ها و رویدادهای دریافتی ربات را نمایش می‌دهد.

این بخش به شما کمک می‌کند تا:

عملکرد ربات را بررسی کنید - ببینید کاربران چه پیام‌هایی ارسال می‌کنند
عیب‌یابی کنید - در صورت عدم پاسخ‌دهی ربات، مشکل را پیدا کنید
الگوهای رفتاری را شناسایی کنید - ببینید کاربران بیشتر از چه دستوراتی استفاده می‌کنند

امکانات بخش آپدیت‌ها:
فیلتر بر اساس نوع - پیام جدید، ویرایش پیام، حذف پیام
فیلتر بر اساس نوع چت - پی وی، گروه یا کانال
جستجو - جستجو در متن پیام‌ها
مشاهده داده خام - مشاهده JSON کامل هر آپدیت برای بررسی دقیق‌تر
صفحه‌بندی - نمایش ۲۰ آپدیت در هر صفحه

نکته: آپدیت‌ها تا زمانی که ربات فعال است، ذخیره می‌شوند. با حذف ربات، تمام آپدیت‌ها نیز حذف می‌شوند.
با استفاده از بخش ارسال پیام همگانی می‌توانید به تمام کاربران یا گروه‌های فعال پیام ارسال کنید.

📨 ارسال به کاربران:
• پیام به تمام کاربرانی که ربات را استارت کرده‌اند ارسال می‌شود
• کاربرانی که ربات را بلاک کرده‌اند، به‌طور خودکار از لیست حذف می‌شوند

📢 ارسال به گروه‌ها:
• پیام به تمام گروه‌هایی که ربات را فعال کرده‌اند ارسال می‌شود
• گروه‌هایی که ربات در آنها نیست، به‌طور خودکار از لیست حذف می‌شوند

نکته: ارسال پیام همگانی از طریق وب‌هوک انجام می‌شود و به اینترنت پایدار نیاز دارد.

مدیریت فایل‌ها

برای استفاده از فایل در قابلیت‌های ربات، ابتدا باید فایل را آپلود کنید.

📤 مراحل آپلود فایل:
۱. به بخش مدیریت فایل‌ها در صفحه جزئیات ربات بروید.
۲. فایل خود را بکشید و در بخش آپلود رها کنید یا روی آن کلیک کنید.
۳. منتظر بمانید تا فایل آپلود شود.
۴. فایل‌آیدی تولید شده را کپی کنید.

📂 انواع فایل‌های قابل آپلود:
• عکس (Image) - jpg, png, gif, webp (حداکثر ۱۰ مگابایت)
• ویدئو (Video) - mp4 (حداکثر ۵۰ مگابایت)
• صوت (Audio) - mp3
• فایل (Document) - انواع فایل‌ها (حداکثر ۵۰ مگابایت)
• گیف (Gif) - mp4 بدون صدا
• استیکر (Sticker)

نکته: فایل‌آیدی پس از آپلود در دیتابیس ذخیره می‌شود و می‌توانید در هر زمان از آن استفاده کنید.
پس از آپلود فایل، می‌توانید از فایل‌آیدی در قابلیت‌های ربات استفاده کنید.

📝 مراحل استفاده:
۱. در زمان افزودن یا ویرایش قابلیت، فایل‌آیدی را در فیلد فایل آیدی وارد کنید.
۲. اگر متن پاسخ وجود داشته باشد، فایل همراه با متن ارسال می‌شود.
۳. اگر متن پاسخ خالی باشد، فقط فایل ارسال می‌شود.

نکته: می‌توانید از یک فایل در چندین قابلیت استفاده کنید.

❓ سوالات متداول

❓ چگونه ربات بسازم؟
از @BotFather توکن دریافت کنید، آن را در ربات‌ساز وارد کنید و روی دکمه ساخت کلیک کنید. ربات شما در کمتر از ۱ دقیقه ساخته می‌شود.
❓ آیا به برنامه‌نویسی نیاز دارم؟
خیر! ربات‌ساز نوویکس بدون نیاز به هیچ گونه کدنویسی کار می‌کند. تمام مراحل از طریق رابط کاربری گرافیکی انجام می‌شود.
❓ ربات من چقدر سریع پاسخ می‌دهد؟
با استفاده از Webhook، پاسخ‌ها به صورت لحظه‌ای و با تاخیر کمتر از ۱ ثانیه ارسال می‌شوند. این سیستم بسیار پایدار و قابل اعتماد است.
❓ چند قابلیت می‌توانم به ربات اضافه کنم؟
شما می‌توانید هر تعداد قابلیت که می‌خواهید به ربات خود اضافه کنید. هیچ محدودیتی برای تعداد قابلیت‌ها وجود ندارد.
❓ آیا می‌توانم ربات را پس از ساخت ویرایش کنم؟
بله! شما می‌توانید در هر زمان قابلیت‌های جدید اضافه کنید، قابلیت‌های موجود را ویرایش یا حذف کنید، و وضعیت ربات را تغییر دهید.
❓ چه تفاوتی بین «شامل کلمه» و «دقیق» وجود دارد؟
در قابلیت «شامل کلمه»، اگر پیام کاربر شامل کلمه مورد نظر باشد (حتی با کلمات دیگر)، پاسخ ارسال می‌شود. اما در قابلیت «دقیق»، پیام کاربر باید دقیقاً برابر با متن مورد نظر باشد.
❓ تفاوت کیبورد شیشه‌ای و کیبورد درون پیام چیست؟
کیبورد شیشه‌ای (Chat Keyboard) دکمه‌ها را در پایین صفحه چت نمایش می‌دهد و با کلیک روی هر دکمه، پیام جدیدی ارسال می‌شود.

کیبورد درون پیام (Inline Keyboard) دکمه‌ها را در داخل پیام نمایش می‌دهد و با کلیک روی هر دکمه، متن همان پیام ویرایش می‌شود.
❓ چگونه فایل همراه با پیام ارسال کنم؟
ابتدا فایل خود را در بخش مدیریت فایل‌ها آپلود کنید. سپس فایل‌آیدی دریافتی را در قابلیت مورد نظر وارد کنید. اگر متن پاسخ وجود داشته باشد، فایل همراه با متن ارسال می‌شود. اگر متن پاسخ خالی باشد، فقط فایل ارسال می‌شود.
❓ چرا ربات من به پیام‌های گروه پاسخ نمی‌دهد؟
ربات‌های روبیکا فقط در صورتی می‌توانند پیام‌های گروه را ببینند که کاربر به ربات ریپلای کرده باشد یا پیام حاوی @username ربات باشد. همچنین مطمئن شوید که ربات را به عنوان ادمین گروه اضافه کرده‌اید و گزینه دریافت همه پیام‌ها را در @BotFather فعال کرده‌اید.
❓ چگونه ربات خود را حذف کنم؟
در صفحه جزئیات ربات، روی دکمه حذف ربات کلیک کنید. توجه داشته باشید که این عمل غیرقابل بازگشت است و تمام قابلیت‌ها و آپدیت‌های ربات نیز حذف می‌شوند.
❓ آیا می‌توانم از یک فایل در چند قابلیت استفاده کنم؟
بله! پس از آپلود فایل، فایل‌آیدی آن در دیتابیس ذخیره می‌شود و می‌توانید در هر تعداد قابلیت که می‌خواهید از آن استفاده کنید.
❓ حداکثر حجم فایل چقدر است؟
حداکثر حجم فایل‌های قابل آپلود ۲۰ مگابایت است. برای عکس‌ها حداکثر ۱۰ مگابایت و برای ویدئو و فایل‌ها حداکثر ۵۰ مگابایت (طبق محدودیت‌های API روبیکا).
❓ دستورات پویا چیست و چگونه استفاده می‌شود؟
دستورات پویا شامل {username}، {name}، {users}، {groups}، {date} و {time} هستند. شما می‌توانید این دستورات را در متن پاسخ قابلیت‌ها قرار دهید تا در زمان اجرا با مقادیر واقعی جایگزین شوند.

مثال: سلام {name} عزیز! خوش آمدید.
آدرس کپی شد