نکات کلیدی
- برای اجرای دائمی ربات بله روی سرور، باید از سرویس systemd استفاده کنید.
- با استفاده از این راهنمای جامع، می توانید ربات بله خود را با پایتون ایجاد کنید و به صورت دائمی روی سرور اجرا کنید.
- برای دریافت توکن ربات بله، از @botfather در خود بله استفاده کنید.
معرفی ربات بله و ساخت آن
ربات بله را می توان با پایتون و استفاده از توکنی که از BotFather بله دریافت می شود، ساخت. برای ساخت ربات بله، دو چیز لازم است: توکنی که @botfather در بله می دهد و اسکریپتی که با getUpdates پیام می خواند و با sendMessage جواب می دهد.
دریافت توکن و امتحان آن
برای دریافت توکن، باید با @botfather گفت وگو کنید و از منوی خودش بازو بسازید. سپس می توانید توکن را با استفاده از دستور getMe امتحان کنید. پاسخ JSON فیلد ok دارد و اگر false باشد، علت در description می آید.
نمونه اولیه
نسخه لپ تاپی ربات بله شامل یک حلقه و توکنی است که وسط کد نشسته. طبق مستندات بله، درخواستی با offset بزرگ تر آپدیت های قبلی را تأیید می کند. limit بین ۱ تا ۱۰۰ است و پارامتر timeout در فهرست getUpdates نیامده، برای همین حلقه یک ثانیه صبر می کند.
اجرای دائمی روی سرور
برای اجرای دائمی ربات بله روی سرور، باید از سرویس systemd استفاده کنید. این سرویس به شما کمک می کند تا ربات بله خود را به صورت دائمی اجرا کنید و در صورت بروز خطا، خودکار ری استارت شود.
نکات کلیدی
- دریافت توکن از BotFather بله
- ساخت نمونه اولیه با getUpdates
- استفاده از سرویس systemd برای اجرای دائمی
- استفاده از دیتابیس برای ذخیره سازی اطلاعات
جمعبندی
ساخت ربات بله با پایتون و اجرای دائمی روی سرور، شامل مراحل مختلف از جمله دریافت توکن، نمونه اولیه با getUpdates، و راه اندازی سرویس systemd است. با استفاده از این راهنمای جامع، می توانید ربات بله خود را با پایتون ایجاد کنید و به صورت دائمی روی سرور اجرا کنید.
انتخاب کتابخانه پایتون و ساخت دستورها و دکمه ها
در این بخش، ما به انتخاب کتابخانه پایتون و ساخت دستورها و دکمه ها برای ربات می پردازیم. ابزار اصلی ساخت ربات در این راهنما، requests است که هر متد بله یک درخواست HTTP است و فقط متدهای مستند صدا زده می شوند. کتابخانه های بزرگ تر درخواست هایی هم می فرستند که باید روی بله امتحان شوند.
ساخت دستور /start و منوی دکمه ای
برای ساخت دستور /start و منوی دکمه ای، ما از ReplyKeyboardMarkup استفاده می کنیم. در این ساختار، فیلد keyboard ردیف هایی از KeyboardButton با فیلد text است و زدن دکمه همان متن را به شکل پیام معمولی می فرستد. پس هر دکمه یک جواب در دیکشنری REPLIES می خواهد. همچنین، متن sendMessage بین ۱ تا ۴۰۹۶ کاراکتر است.
دکمه شیشه ای و callback_data
دکمه شیشه ای (InlineKeyboardButton) جز text فقط url یا callback_data می گیرد. سقف callback_data ۶۴ بایت است و هر حرف فارسی در UTF-8 دو بایت می خورد. برای این منظور، کد کوتاه انگلیسی مثل hours استفاده می شود. کلیک، آپدیتی با callback_query می فرستد و ساختار InlineKeyboardMarkup در مستندات بله تعریف نشده است و باید روی بازوی آزمایشی امتحانش کرد.
انتقال به سرور با systemd و راه برگشت به نسخه قبل
برای انتقال به سرور با systemd و راه برگشت به نسخه قبل، کد در پوشه ای با تاریخ انتشار می نشیند، توکن زیر /etc و داده زیر /var/lib قرار می گیرد. systemd ربات را بعد از ریبوت و خطا بالا می آورد و برگشت یک پیوند نمادین است. این دستورها لینوکسِ دارای systemd می خواهند و تصمیم بین لینوکس و ویندوز برای سرور مجازی باید پیش از این بخش گرفته شود.
توکن در فایل محیطی سرور
در فایل bot.py، توکن از os.environ[‘BALE_TOKEN’] خوانده می شود. برای این منظور، فایل محیطی را از اول با دسترسی 600 بسازید تا حتی یک لحظه برای دیگران خواندنی نباشد. این کار به منظور حفظ امنیت توکن انجام می شود.
محیط ربات و نسخهها
برای راهاندازی ربات بله، ابتدا پوشه نسخهها و پیوند current را تنظیم کنید. هر انتشار پوشه و venv خودش را دارد تا در صورت نیاز به برگشت، کتابخانهها را هم برگرداند. برای انتقال bot.py و requirements.txt (با یک خط requests==2.34.2) به پوشه نسخه، از scp یا git استفاده کنید.
داخل پوشه نسخه، به دلیل اینکه /opt مال root است، sudo python3 -m venv venv و sudo venv/bin/pip install -r requirements.txt را اجرا کنید. یونیت فقط current را میشناسد. برای فعالسازی، از دستورات sudo systemctl daemon-reload و sudo systemctl enable –now balebot استفاده کنید.
انتشار و برگشت
برای انتشار و برگشت، از پیوند نمادین استفاده کنید. با دستور ln -sfn، میتوانید پیوند نمادین ایجاد کنید، مقصد موجود را جایگزین کنید و از ایجاد پیوند تازه در پوشه قبلی جلوگیری کنید. برای انتشار، sudo ln -sfn /opt/balebot/releases/2026-11-04 /opt/balebot/current و سپس sudo systemctl restart balebot را اجرا کنید. برای برگشت، همان دو فرمان را با پوشه 2026-11-02 اجرا کنید.
خطاها و مشکلات
اگر ربات خراب شد، ابتدا با پیوند current برگردید، سپس journalctl -u balebot -e را بخوانید. نبودن BALE_TOKEN میتواند منجر به KeyError پشت سر هم، هر پنج ثانیه یک بار.
دادههای کاربران
برای نگهداری دادههای کاربران، از فایل SQLite بیرون از پوشه نسخهها استفاده کنید. sqlite3 در کتابخانه استاندارد پایتون است و StateDirectory=balebot پوشه /var/lib/balebot را برای کاربر سرویس میسازد و با توقف سرویس نگه میدارد.
کد ربات
کد ربات باید به گونهای نوشته شود که در صورت بروز خطا، سرویس ری استارت نشود. بلوک try دور handle عمدی است و کاربری که ربات را بسته، هر بار خطای sendMessage میگیرد. بدون try، پروسه میافتد، systemd بالایش میآورد و همان آپدیت تأییدنشده دوباره میرسد.
توکن ربات
برای دریافت توکن ربات بله، از @botfather در خود بله استفاده کنید. با دستور getMe میتوانید توکن را امتحان کنید.
کتابخانههای تلگرام
کتابخانه python-telegram-bot با base_url به tapi.bale.ai وصل میشود. هر قابلیتش را روی بله امتحان کنید.
مشکلات رایج
ربات روی لپ تاپ جواب میدهد و روی سرور ساکت است؟ لاگ را با journalctl -u balebot -e بررسی کنید. معمولاً فایل محیطی نیست، BALE_TOKEN خالی است یا پایتون سرور برای requests 2.34.2 قدیمی است.
پیامهای رسیده
پیامهای رسیده به ربات خاموش تا کی در بله میمانند؟ بله فعلاً ۲۰۰۰ پیام آخر را ۲۴ ساعت نگه میدارد؛ بعد از آن ممکن است بخشی از دست برود.
با کلیک روی دکمه شیشهای
با کلیک روی دکمه شیشهای چه چیزی به ربات میرسد؟ آپدیتی با callback_query که data آن همان callback_data دکمه است، حداکثر ۶۴ بایت.
فایل bot.env
فایل bot.env را هم در مخزن git بگذارم؟ نه؛ فقط یک bot.env.example بدون توکن.
مراحل راهاندازی ربات بله
ساخت ربات بله با یک توکن و یک حلقه getUpdates ربات را فعال میکند. این ربات با توکنی که در /etc/balebot/bot.env با دسترسی 600 قرار میگیرد، کار خود را آغاز میکند. هر انتشار این ربات پوشه و محیط مجازی اختصاصی خود را دارد.
مدیریت ربات با systemd
سیستمد ربات را پس از بروز خطا یا ریبوت دوباره فعال میکند. در صورت نیاز به بازنشانی، یک لینک نمادین با ln -sfn ایجاد میشود. همچنین، خطای یک آپدیت ثبت و رد میشود و آخرین update_id در پایگاه داده SQLite ذخیره میشود تا در صورت ریاستارت، پاسخ تکراری ارسال نشود.
وب هوک و شبکه
در صورتی که وب هوک با گواهی TLS یا ربات روبیکا مورد نیاز باشد، میتوان از راهنمای زیر برای میزبانی ربات بله استفاده کرد. این راهنمای جامع، مراحل میزبانی ربات بله را به طور کامل پوشش میدهد.
- برای میزبانی ربات بله، باید ابتدا محل ذخیرهسازی فهرست کاربران را مشخص کرد. این فهرست میتواند در حافظه یا در فایل ذخیره شود.
- سپس باید منابع مورد نیاز را مطالعه کرد، از جمله مستندات رسمی Bot API بله، مستندات systemd.exec، مستندات systemd.service، مستندات پایتون: ماژول sqlite3، و راهنمای شروع سریع Requests.
- مطالعه مستندات رسمی Bot API بله
- بررسی مستندات systemd.exec و systemd.service
- استفاده از مستندات پایتون: ماژول sqlite3
- مطالعه راهنمای شروع سریع Requests
با پیروی از این مراحل و استفاده از منابع موجود، میتوان ربات بله را به طور کامل میزبانی کرد و از ویژگیهای آن به طور مؤثر استفاده کرد.
پرسشهای متداول
چگونه می توان توکن ربات بله را دریافت کرد؟
توکن ربات بله را می توان از BotFather بله دریافت کرد.
چگونه می توان ربات بله را به صورت دائمی روی سرور اجرا کرد؟
برای اجرای دائمی ربات بله روی سرور، باید از سرویس systemd استفاده کرد.
چگونه می توان اطلاعات ربات بله را ذخیره سازی کرد؟
می توان از دیتابیس برای ذخیره سازی اطلاعات ربات بله استفاده کرد.

کمپین ابتکار نو
کمپین ایده های نو
کمپین آینده روشن
کمپین طراحی مدرن