📖 راهنما

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

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

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

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

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

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

دستورات BotFather سروش پلاس:
• /newbot - ساخت بات جدید
• /mybots - ویرایش بات‌ها
• /setname - تغییر عنوان بات
• /setabouttext - تغییر اطلاعات درباره بات
• /setprofilepic - تغییر عکس پروفایل بات
• /token - دریافت توکن
• /revoke - باطل کردن توکن بات و دریافت توکن جدید

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

VIP

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

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

کاربرد: تبدیل متن به فایل صوتی برای ارسال در سروش پلاس.

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

محدودیت: حداکثر ۱۰۰۰ کاراکتر برای هر تبدیل.

مثال:
متن محرک: «تبدیل»
ورودی کاربر: «تبدیل سلام به همه دوستان»
نتیجه: فایل صوتی «سلام به همه دوستان»

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

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

📨 ارسال عادی (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) دکمه‌ها را در داخل پیام نمایش می‌دهد و با کلیک روی هر دکمه، متن همان پیام ویرایش می‌شود.
❓ چگونه فایل همراه با پیام ارسال کنم؟ ▼
ابتدا فایل خود را در بخش مدیریت فایل‌ها آپلود کنید. سپس فایل‌آیدی دریافتی را در قابلیت مورد نظر وارد کنید. اگر متن پاسخ وجود داشته باشد، فایل همراه با متن ارسال می‌شود. اگر متن پاسخ خالی باشد، فقط فایل ارسال می‌شود.
❓ چگونه ربات خود را حذف کنم؟ ▼
در صفحه جزئیات ربات، روی دکمه حذف ربات کلیک کنید. توجه داشته باشید که این عمل غیرقابل بازگشت است و تمام قابلیت‌ها و آپدیت‌های ربات نیز حذف می‌شوند.
❓ آیا می‌توانم از یک فایل در چند قابلیت استفاده کنم؟ ▼
بله! پس از آپلود فایل، فایل‌آیدی آن در دیتابیس ذخیره می‌شود و می‌توانید در هر تعداد قابلیت که می‌خواهید از آن استفاده کنید.
❓ حداکثر حجم فایل چقدر است؟ ▼
حداکثر حجم فایل‌های قابل آپلود ۲۰ مگابایت است. برای عکس‌ها حداکثر ۱۰ مگابایت و برای ویدئو و فایل‌ها حداکثر ۵۰ مگابایت (طبق محدودیت‌های API سروش پلاس).
❓ دستورات پویا چیست و چگونه استفاده می‌شود؟ ▼
دستورات پویا شامل {username}، {name}، {users}، {date} و {time} هستند. شما می‌توانید این دستورات را در متن پاسخ قابلیت‌ها قرار دهید تا در زمان اجرا با مقادیر واقعی جایگزین شوند.

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