به آسانی ربات تلگرامی خود را بسازید!

یکی از اولین دغدغه‌های کسی که می‌خواهد ربات تلگرامی بسازد، این است که نمی‌داند از چه کتابخانه‌ای استفاده کند. اولین رباتی که ساختم، از هیچ کتابخانه‌ای استفاده نمی‌کرد و نامرتب‌بودن کدها بسیار آزاردهنده بود. بعدها با چند کتابخانه آشنا شدم و ربات‌های مختلفی را با یکی از آنها ساختم، روش استفاده نسبتاً آسان بود و وقتی IDE متدها را پیدا کرده بود، کارها با سرعت خوبی پیش می‌رفت.مدت‌ها گذشت و به Bot API تلگرام، متدهای جدیدی اضافه شد که آن کتابخانه نمی‌توانست پشتیبانی کند. اکنون باید چه می‌کردم؟ مجبور شدم که کلاس‌هایی را به کتابخانه اضافه کنم و برای نویسنده بفرستم تا ادغام کند، اما روندی نبود که در زمان کوتاهی انجام شود، و بعد پرسیدم: چرا برای آسانی کارم، یک کتابخانه برای خودم ننویسم؟ کتابخانه‌ای که نیازهای همیشگی‌ام را برآورده کند و کمبودهای کتابخانه‌های قبلی را نداشته باشد؟معرفینام این کتابخانه را TeleBot گذاشته‌ام؛ کم‌حجم و سبک است و در حال حاضر نیازهای اصلی را رفع می‌کند و در آینده امکانات جدیدی اضافه خواهد شد تا کار توسعه‌دهندگان دیگر را آسان‌تر کند. برای اینکه انعطاف‌پذیری کتابخانه بالا باشد، تمامی متدهای مربوط به تلگرام، به صورت داینامیک کار می‌کنند، پس در صورت ارائه‌شدن متدهای جدید، کلاس اصلی ما دست‌نخورده باقی می‌ماند.راهنمای نصببرای نصب این پکیج، نیاز به Composer دارید؛ با دستور زیر می‌توانید پکیج را به پروژه‌ی خود اضافه کنید:composer require webpajooh/telebotچگونه کار می‌کند؟بعد از ساخت ربات در Botfather یک Token تحویل گرفته‌اید که برای ارتباط با ربات ضروری است. یک شیء از کلاس TeleBot بسازید و توکن را معرفی کنید:$tg = new TeleBot('Your-Token');بعد از این، tg$ در اختیار شماست تا دستورها را اجرا کنید. به این مثال دقت کنید:دریافت دستورات کاربر در ربات تلگرام و پاسخ به کاربربا استفاده از listen، منتظر یک دستور از سوی کاربر می‌مانیم؛ اگر کاربر دستوری که توقع داشته‌ایم را ارسال کند، بدنه اجرا می‌شود و در غیر این صورت، سایر مسیرها بررسی خواهد شد. به آسانی می‌توانید ورودی کاربر را تجزیه و تحلیل کنید و نیازی نیست کدهای اضافی بنویسید، در اولین قسمتی که می‌بینید، با d% یک عدد را مشخص کرده‌ایم که کاربر آن را وارد کرده است، و بعد متغیر age$ همان عدد را در خود دارد، و همینطور می‌توانیم متغیرهای بیشتری را در دستورات خود بگنجانیم.یکی از ویژگی‌های کتابخانه‌ی TeleBot این است که ساختن کیبورد را آسان کرده است و نیازی به نوشتن آرایه‌های پر پیچ و خم نیست! در کد بالا یک کیبورد Inline (به قول بعضی از بچه‌ها، کیبورد شیشه‌ای!) با دو دکمه ساخته‌ایم که هر کدام لینک خود را دارند و در آخر با متد get می‌توانیم کیبورد را بگیریم و برای متد sendMessage ارسال کنیم.یکی دیگر از ویژگی‌هایی که می‌تواند به‌دردبخور باشد، لاگری است که یک فایل لاگ را ایجاد کرده و پیامی که توسعه‌دهنده وارد کرده را در آن می‌نویسد. متد log از کلاس Logger فرقی با هلپر tl ندارد و هر دو یک کار را انجام می‌دهند، پس می‌توانید از دومی به عنوان یک جایگزین آسان استفاده کنید.سفارشی‌سازی کیبوردی که در ربات تلگرامی نمایش داده می‌شودکد بالا، یک کیبورد از نوع Reply keyboard ساخته که چهار دکمه دارد. بجای اینکه دکمه‌ها جداگانه اضافه شوند، می‌توانیم همه را به عنوان پارامتر به متد addButtons معرفی کنیم، و بعد با متد chunk تعیین کنیم که در هر سطر، چند دکمه باشد. از آنجا که در ربات‌های فارسی نیاز داریم که اولین دکمه در سمت راست نمایش داده شود، متد rightToLeft کیبورد را راست‌چین می‌کند و یکی از مشکلات دیرینه‌ی ما را حل خواهد کرد.می‌توانید TeleBot را در گیت‌هاب و Packagist ببینید.شما چه پیشنهادی برای این کتابخانه دارید؟ مشارکت آزاد است و انتقادات را با مهربانی می‌شنوم!