هاست ربات بله، روبیکا و ایتا چیست
این سرویس هاست اشتراکی cPanel روی سرور ایران است که برای اجرای ربات پیام رسان های داخلی آماده شده. سرور در دیتاسنتر تهران است و API ربات بله (tapi.bale.ai)، API ربات روبیکا (botapi.rubika.ir) و API ایتایار (eitaayar.ir) از همین سرور جواب می دهند. پیش از راه اندازی این سرویس، اتصال به هر سه را از خود سرور آزمایش کرده ایم.
ربات این پیام رسان ها روی شبکه داخلی کار می کند و برای وصل شدن به آن ها لازم نیست سرور خارج از ایران بگیرید. سورس ربات، دیتابیس و فایل ها روی همان هاست قرار می گیرند و از cPanel مدیریتشان می کنید.
چه زبان ها و ابزارهایی در دسترس است
- پایتون: از بخش Setup Python App نسخه پایتون را انتخاب می کنید (از جمله نسخه های 3.10، 3.11 و 3.12) و برنامه در محیط مجازی جدا اجرا می شود.
- Node.js: از بخش Node.js App نسخه را انتخاب و برنامه را راه اندازی می کنید (از جمله نسخه های 18 و 20).
- PHP: برای ربات های PHP نسخه PHP قابل تغییر است و اسکریپت با وبهوک یا کرون اجرا می شود.
- کرون جاب: برای اجرای زمان بندی شده اسکریپت ها، مثلا هر یک دقیقه.
- دیتابیس MySQL و PostgreSQL برای ذخیره کاربران و داده های ربات.
این پلن ها مثل هاست ربات تلگرام دسترسی ترمینال (SSH) ندارند. پکیج های پایتون را از صفحه همان برنامه در Setup Python App نصب می کنید؛ کافی است فایل requirements.txt را بالا بیاورید و نصب را از همان صفحه اجرا کنید. اگر پروژه شما به ترمینال نیاز دارد، هاست پایتون با دسترسی ترمینال را ببینید.
بدون دامنه هم شروع کنید
هنگام سفارش می توانید به جای دامنه، یک زیردامنه رایگان انتخاب کنید. گواهی SSL رایگان روی همین زیردامنه صادر می شود، پس آدرس https لازم برای وبهوک از همان اول آماده است. بعدا اگر دامنه خودتان را خواستید، از صفحه ثبت دامنه بگیرید و به هاست وصل کنید.
وبهوک یا گرفتن پیام ها با درخواست؛ کدام را انتخاب کنیم
ربات به دو روش پیام های کاربران را دریافت می کند:
- وبهوک: آدرس یک فایل روی هاست را به پیام رسان می دهید و هر پیام تازه به همان آدرس فرستاده می شود. اسکریپت فقط وقتی پیامی برسد اجرا می شود و منابع هاست را بیهوده مصرف نمی کند. API ربات بله مثل API تلگرام متد setWebhook دارد و روبیکا هم ثبت آدرس دریافت پیام را پشتیبانی می کند.
- درخواست دوره ای پیام ها (getUpdates): ربات خودش هر چند ثانیه از سرور پیام رسان می پرسد پیام تازه ای هست یا نه. این روش یک پروسه همیشه روشن می خواهد.
روی هاست اشتراکی وبهوک روش درست و پایدار است. اگر سورس شما فقط با درخواست دوره ای کار می کند، آن را طوری بنویسید که با کرون جاب هر دقیقه اجرا شود، پیام های تازه را بگیرد و تمام شود، نه این که یک حلقه بی پایان باشد. برای ربات های سنگین که باید شبانه روز پروسه زنده داشته باشند، سرور مجازی ایران انتخاب مناسب تری است.
API ایتایار بیشتر برای فرستادن پیام و فایل به کانال ها و گروه های ایتا استفاده می شود. برای این کار معمولا یک اسکریپت ساده با کرون جاب کافی است، مثلا انتشار خودکار مطلب سایت در کانال.
راه اندازی ربات بله روی هاست در چند قدم
- از ربات سازنده بله توکن ربات بگیرید.
- پلن را سفارش دهید و زیردامنه رایگان را انتخاب کنید. اطلاعات ورود به cPanel بعد از پرداخت خودکار فرستاده می شود.
- در Setup Python App یا Node.js App برنامه را بسازید، فایل های ربات را بالا بیاورید و پکیج ها را نصب کنید. برای PHP فایل ها را در پوشه سایت قرار دهید.
- آدرس https فایل وبهوک را با متد setWebhook به API بله معرفی کنید.
- یک پیام به ربات بفرستید و لاگ برنامه را در cPanel ببینید تا مطمئن شوید پیام می رسد.
کتابخانه هایی که برای ربات تلگرام نوشته شده اند، با تغییر آدرس API گاهی برای بله هم کار می کنند، چون ساختار API بله شبیه تلگرام است. پیش از استفاده، مستندات رسمی هر پیام رسان را بخوانید.
کدام پلن را بگیرم
تعداد ربات در هر پلن سقف منصفانه استفاده است، نه محدودیت فنی دقیق. معیار اصلی رم و تعداد هسته است:
- پلن 1 برای یک ربات وبهوکی یا یک اسکریپت ارسال پیام به کانال کافی است.
- پلن 2 برای چند ربات کوچک یا رباتی با دیتابیس و کاربران بیشتر.
- پلن 3 برای ربات هایی که پردازش بیشتری دارند، مثلا پردازش فایل یا گزارش گیری.
- پلن 4 برای چند پروژه هم زمان یا رباتی که کاربران زیادی دارد.
هر وقت منابع کم آمد، از ناحیه کاربری یا با تیکت پلن را ارتقا بدهید. پرداخت ماهانه، سه ماهه، شش ماهه و سالانه در سبد خرید قابل انتخاب است.
چرا سرور ایران برای ربات های پیام رسان داخلی
وقتی ربات و سرور پیام رسان هر دو داخل ایران باشند، مسیر شبکه کوتاه است و پاسخ ربات به وضعیت اینترنت بین الملل وابسته نیست. اگر ربات شما به سرویس های داخلی دیگری هم وصل می شود، مثل درگاه پرداخت بانکی برای ربات فروشگاهی، سامانه پیامک یا API یک سایت ایرانی، روی سرور ایران همه این اتصال ها از شبکه داخلی انجام می شوند. بیشتر این سرویس ها از سرور خارج یا جواب نمی دهند یا اتصال آن ها کند و ناپایدار است.
برای ربات هایی که کاربرانشان داخل ایران هستند، مثل ربات پشتیبانی یک فروشگاه، ربات نوبت دهی یا ربات اطلاع رسانی یک کانال، این تفاوت در سرعت پاسخ دیده می شود.
نگهداری امن توکن و اطلاعات ربات
توکن ربات مثل رمز عبور است و هر کس آن را داشته باشد، کنترل ربات را در دست می گیرد. چند کار ساده جلوی بیشتر مشکل ها را می گیرد:
- توکن را در کد ننویسید. در Setup Python App و Node.js App می توانید متغیر محیطی تعریف کنید و توکن را از آن بخوانید.
- فایل های تنظیمات و دیتابیس SQLite را بیرون از پوشه public_html نگه دارید تا از طریق وب در دسترس نباشند.
- آدرس وبهوک را حدس پذیر نسازید؛ یک مسیر طولانی و تصادفی برای آن انتخاب کنید و در صورت امکان توکن مخفی وبهوک را هم بررسی کنید.
- اگر توکن لو رفت، از بخش ساخت ربات پیام رسان توکن تازه بگیرید و توکن قبلی را باطل کنید.
لاگ و عیب یابی ربات
اگر ربات جواب نمی دهد، اول لاگ را ببینید. برای برنامه های پایتون و Node.js مسیر فایل لاگ در صفحه همان برنامه در cPanel آمده است و برای PHP فایل error_log در پوشه اسکریپت ساخته می شود. خطاهای رایج این ها هستند: پکیجی نصب نشده، نسخه پایتون با سورس هماهنگ نیست، آدرس وبهوک به جای https با http ثبت شده، یا فایل شروع برنامه درست معرفی نشده است.
اگر ربات گاهی کند می شود، در cPanel بخش Resource Usage را ببینید. این بخش نشان می دهد برنامه به سقف رم، CPU یا تعداد پروسه پلن رسیده است یا نه. اگر مدام به سقف می رسید، اول کد را بررسی کنید، مثلا حلقه های بی پایان یا درخواست های تکراری، و اگر مشکل از حجم کار بود، پلن را ارتقا بدهید.
دیتابیس و ذخیره اطلاعات کاربران
برای ربات های کوچک فایل SQLite کافی است. وقتی تعداد کاربران زیاد شد یا چند بخش هم زمان روی داده ها کار می کنند، دیتابیس MySQL یا PostgreSQL را از cPanel بسازید و ربات را به آن وصل کنید. از دیتابیس به طور منظم خروجی بگیرید و یک نسخه را بیرون از هاست نگه دارید؛ روش کار در بکاپ و بازگردانی در cPanel آمده است.
قوانین استفاده
استفاده از این هاست برای ارسال انبوه پیام، اسپم یا هر کاری که با قوانین پیام رسان ها و قوانین سرویس دهی پیکوهاست در تضاد باشد مجاز نیست. ربات هایی که برای کاربران مفیدند و محدودیت های API هر پیام رسان را رعایت می کنند، بدون مشکل اجرا می شوند.
ربات تلگرام دارید؟
API تلگرام از داخل ایران در دسترس نیست، پس ربات تلگرام روی این سرور اجرا نمی شود. برای ربات تلگرام هاست ربات تلگرام روی سرور آلمان را ببینید. اگر یک ربات را هم برای تلگرام و هم برای بله دارید، می توانید هر نسخه را روی سرور مناسب خودش اجرا کنید.