معرفی دوره

در این درس با مفاهیم پایه موردنیاز برای شروع دوره آشنا می‌شوید؛ از نحوه ارتباط برنامه با سرور، API، Request و Response گرفته تا JSON، کتابخانه Requests، فایل .env و محیط مجازی venv که در تمام طول دوره از آن‌ها استفاده خواهیم کرد.

در این درس اولین بازوی بله را ایجاد می‌کنیم، Token دریافت می‌کنیم، محیط توسعه Python را آماده می‌کنیم و اولین درخواست خود را به API بله ارسال می‌کنیم تا با ساختار درخواست‌ها و پاسخ‌های API آشنا شویم.

در این درس با ساختار پاسخ متد getUpdates آشنا می‌شوید، اطلاعات مهمی مانند chat_id، text و update_id را استخراج می‌کنید و با استفاده از متد sendMessage اولین پیام را برای کاربر ارسال خواهید کرد و اولین تعامل با بازوی بله را تجربه می‌کنید.

در این درس یاد می‌گیرید چگونه اسکریپت ساده خود را به یک بازوی دائماً در حال اجرا تبدیل کنید. با استفاده از حلقه while True، مفهوم Polling، مدیریت offset، دریافت پیوسته پیام‌های جدید، ارسال پاسخ خودکار و جلوگیری از پردازش تکراری پیام‌ها آشنا می‌شوید.

در این درس با Inline Keyboard آشنا می‌شوید و یاد می‌گیرید چگونه دکمه‌های تعاملی داخل پیام ایجاد کنید. همچنین نحوه مدیریت callback_query، دریافت callback_data، پاسخ به کلیک کاربران و ساخت منوهای چندمرحله‌ای و سلسله‌مراتبی را آموزش خواهید دید تا ربات شما تجربه کاربری حرفه‌ای‌تری ارائه دهد

در این درس با متدهای ارسال انواع پیام در API بله آشنا می‌شوید و یاد می‌گیرید چگونه علاوه بر پیام متنی، تصاویر، فایل‌ها، ویدئو، فایل صوتی، پیام صوتی و موقعیت مکانی (Location) را برای کاربران ارسال کنید

در این درس با نحوه دریافت پیام‌های کاربران با استفاده از رویداد on_message آشنا می‌شوید و یاد می‌گیرید چگونه با متدهای reply و send_message به پیام‌ها پاسخ دهید. همچنین تفاوت بین ارسال پیام به‌صورت Reply و ارسال یک پیام عادی در همان گفت‌وگو را به‌صورت عملی بررسی خواهیم کرد.

در این درس یاد می‌گیرید چگونه کلیک کاربران روی دکمه‌های Inline Keyboard را مدیریت کنید. با دریافت callback_query، نمایش اعلان (Popup)، ارسال پیام جدید، ویرایش و حذف پیام‌ها آشنا می‌شوید و نحوه طراحی منوهای تعاملی و چندمرحله‌ای را به‌صورت عملی پیاده‌سازی خواهید کرد.

نحوه ی ارسال و دریافت فایل و ویدئو، دانلود فایل کاربران، ذخیره آن ها در سیستم و همچنین حذف و ویرایش پیام ها و دکمه های اینلاین را یاد میگیرید

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

در این درس دریافت فایل‌ها را به فرمت‌های مشخص محدود کنیم. با استفاده از نوع فایل (MIME Type) و تشخیص پسوند واقعی، فقط فایل‌های مجاز مانند JPG، JPEG و ZIP را دریافت کرده و از دانلود فایل‌های غیرمجاز یا ناخواسته جلوگیری می‌کنیم. این کار باعث افزایش امنیت، کاهش مصرف منابع و کنترل بهتر فایل‌های دریافتی در ربات می‌شود

در این درس با رویدادهای عضویت کاربران در گروه آشنا می‌شویم و یاد می‌گیریم چگونه ورود اعضای جدید را تشخیص دهیم. همچنین با استفاده از رویداد new_chat_members برای کاربران جدید پیام خوش‌آمدگویی ارسال می‌کنیم.

این درس یاد می‌گیریم چگونه شناسه (ID) گروه را از طریق ربات دریافت کنیم،رویدادهای ورود اعضای جدید را مدیریت کنیم و اطلاعات کاربران رو ذخیره کنیم

در این درس یاد می‌گیرید چگونه با استفاده از لیست کاربران ذخیره‌شده، پیام، تصویر یا فایل را به‌صورت همگانی برای همه کاربران ربات ارسال کنید. همچنین با اجرای فایل مدیریتی جداگانه، مدیریت خطاها، نمایش وضعیت ارسال، ایجاد تأخیر بین درخواست‌ها و ادامه ارسال از یک کاربر مشخص آشنا می‌شوید تا فرآیند Broadcast به‌صورت حرفه‌ای و مطمئن انجام شود.

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

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

در این بخش، تمام مباحثی که تا اینجا یاد گرفته‌ایم را در قالب یک پروژه واقعی پیاده‌سازی می‌کنیم. یک ربات فروش دوره آموزشی می‌سازیم که بدون استفاده از Django یا هر بک‌اند دیگری، امکاناتی مانند نمایش دوره‌ها، ثبت کاربران، مدیریت سفارش‌ها، پرداخت، ثبت تراکنش‌ها و تحویل خودکار محصول را با استفاده از فایل‌های JSON پیاده‌سازی می‌کند. در این پروژه، آموزش‌ها به‌صورت کاملاً مرحله‌به‌مرحله پیش می‌روند و در هر درس تنها بخش موردنیاز پروژه را پیاده‌سازی و ساختار آن را تکمیل می‌کنیم تا در پایان، یک ربات کاربردی و آماده برای توسعه در اختیار داشته باشیم.

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

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

در این درس فرآیند خرید را کامل می‌کنیم. پس از انتخاب دوره، ابتدا سفارش کاربر با وضعیت Pending در فایل JSON ثبت می‌شود، سپس اطلاعات سفارش به درگاه پرداخت ارسال و فاکتور خرید برای کاربر ایجاد می‌شود. پس از پرداخت موفق نیز با استفاده از شناسه سفارش (Payload)، سفارش شناسایی شده و وضعیت آن از Pending به Paid تغییر می‌کند تا فرآیند خرید به‌صورت کامل ثبت و آماده تحویل محصول باشد.

در این درس مرحله نهایی فرآیند خرید را تکمیل می‌کنیم. پس از تأیید پرداخت، سفارش کاربر بررسی شده و وضعیت آن به Paid تغییر می‌کند. سپس اطلاعات دوره از فایل courses.json خوانده شده و فایل ZIP مربوط به همان دوره به‌صورت خودکار برای کاربر ارسال می‌شود. همچنین وجود فایل قبل از ارسال بررسی می‌شود تا در صورت حذف یا جابه‌جایی فایل، پیام مناسب به کاربر نمایش داده شده و از بروز خطا جلوگیری شود.

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

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

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

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

در این بخش پروژه را از محیط توسعه خارج کرده و روی هاست اجرا می‌کنیم تا ربات به‌صورت دائمی و مستقل از سیستم شخصی فعال باشد. در این مرحله با آماده‌سازی پروژه برای استقرار، مدیریت وابستگی‌ها با requirements.txt، اجرای خودکار برنامه، بررسی Logها و رفع خطاهای رایج آشنا می‌شویم

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

در این درس قابلیت نمایش و حذف کدهای تخفیف از پنل مدیریت ربات پیاده‌سازی می‌شود. مدیر می‌تواند از لیست کدهای موجود، کد موردنظر را انتخاب کرده و آن را از فایل discounts.json حذف کند. همچنین نتیجه عملیات حذف به‌صورت پیام داخل ربات نمایش داده می‌شود.

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

در این درس سیستم ثبت تیکت پشتیبانی برای کاربران پیاده‌سازی می‌شود. کاربر با انتخاب بخش پشتیبانی، پیام خود را ارسال می‌کند و اطلاعات تیکت شامل شناسه کاربر، متن پیام، شماره تیکت و وضعیت آن در فایل tickets.json ذخیره می‌شود. همچنین با استفاده از State مشخص می‌شود پیام بعدی کاربر مربوط به ثبت تیکت است و پس از ذخیره، کاربر از این وضعیت خارج می‌شود. همینطور امکان مشاهده تیکت‌های ثبت‌شده کاربران در پنل مدیریت ربات پیاده‌سازی می‌شود. تیکت‌های باز از فایل tickets.json خوانده شده و مدیر می‌تواند هر تیکت را انتخاب کرده و اطلاعاتی مانند شماره تیکت، شناسه کاربر و متن پیام را مشاهده کند.

در این درس امکان مشاهده جزئیات کامل تیکت‌های کاربران پیاده‌سازی می‌شود. مدیر می‌تواند یک تیکت را از لیست انتخاب کرده و شماره تیکت، شناسه کاربر، وضعیت و متن پیام ثبت‌شده را مشاهده کند.

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

در این درس اطلاعات اشتراک کاربر پس از پرداخت موفق ثبت می‌شود. تاریخ شروع و پایان عضویت بر اساس مدت پلن محاسبه شده و اطلاعاتی مانند شناسه کاربر، پلن انتخاب‌شده، تاریخ اعتبار و وضعیت اشتراک در فایل subscriptions.json ذخیره می‌شود.

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

در این درس ارتباط اولیه بین فروشگاه Django و بله پیاده‌سازی می‌شود

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

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

در این درس ربات بله به اطلاعات مشتریان و سفارش‌ها در Django متصل می‌شود. با ارسال دستور /start، کاربر بر اساس Bale Chat ID شناسایی شده و آخرین سفارش ثبت‌شده او از دیتابیس دریافت می‌شود. سپس شماره سفارش و آخرین وضعیت آن مستقیماً داخل ربات بله برای کاربر نمایش داده می‌شود.