برنامه نویسی ربات تلگرام
درس چهارم: فایل TBS (Telegram Bot Simple Api)
به ورژن 2 آپدیت شد

در سه پست قبل، با ابتدایی ترین مسائل ساخت ربات تلگرام، به صورت کلیشه‌ای و خلاصه آشنا شدیم؛ همچنین توانستیم رباتی ساده بسازیم که با دریافت هرپیامی از کاربر، یک پیام با متن دلخواه به او ارسال کند. اما در این پست…

مقدمه

اگر به خاطر بیاورید، در دروس قبلی گفتیم که هدف ما این است تا بدون استفاده از هیچ کتابخانه‌ای که برای کار با API ربات تلگرام نوشته شده است، بتوانیم ربات تلگرام بسازیم؛ و البته در آینده خودمان کتابخانه‌ای برای خودمان طراحی کنیم! همچنین گفتیم که کتابخانه‌های ساخته شده را نیز معرفی خواهیم کرد؛ چرا که بدون شک استفاده از آن‌ها نیز درجای خود، بهترین کار ممکن می‌باشد.

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

پوشه بندی هاست به سبک فول‌کده

اگر قصد ادامه‌ی آموزش‌های مارا دارید، بایستی از منطق ما نیز پیروی کنید؛ یک ساختاربندی یا به عبارتی پوشه‌بندی منحصر به فردی که ما خدمتتان می‌گوییم، در هاست خود بسازید تا همیشه بتوانیم با هم‌دیگر به ساده ترین شکل ممکن مَچ شویم.
بنابراین به ریشه‌ی هاست خود، یعنی به داخل public_html رفته و پوشه‌های زیر را ایجاد کنید:

• fk-tb
  پوشه‌ی مربوط به ربات‌ها
• fk-lib
  پوشه‌ی مربوط به کتابخانه‌های فول‌کده

نکته 1: در پوشه‌ی fk-tb، هر ربات را داخل یک پوشه‌‌ی جدیدی قرار می‌دهیم و بهتر است که نام این پوشه‌ی جدید، نام کاربری ربات باشد!
ولی از آن‌جایی که نام کاربری ثابت نیست و ربات ممکن است بعدا از تلگرام حذف شود، ما نام پوشه را، آیدی عددی رباتی که از طریق بات فادر ایجاد کرده‌ایم قرار می‌دهیم؛ ولی این یک پیشنهاد بوده و همچنان اختیار نام پوشه با خودتان است.

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

نصب Telegram Bot Simple Api

• فایل را از انتهای مطلب دانلود کنید.
• محتوای درون فایل فشرده، یعنی پوشه‌ی tbs را به پوشه‌ی fk-lib در هاست خود انتقال دهید.
  در حال حاظر، این فایل تنها شامل ورژن 1 این کتابخانه می‌باشد.

فراخوانی Telegram Bot Simple Api

ابتدای فایل اصلی هررباتی که از TBS استفاده کند، باید به صورت زیر باشد.

• خط اول: تعریف توکن بات به صورت یک ثابت
• خط دوم: تعریف آیدی عددی ربات به صورت یک ثابت
• خط سوم: تعریف نام کاربری ربات به صورت یک ثابت
• خط چهارم: فراخوانی TBS
  در این‌جا ورژن 2 فراخوانی شده است و در آموزش‌ها ممکن است ورژن های دیگری فراخوانی شود؛ اگر در آموزشی برای مثال ورژن 3 فراخوانی شده بود و شما آن را نداشتید، به این پست آمده و فایل را دوباراه دانلود کنید.

امکانات ورژن های مختلف

ورژن 1

• تابع fktbs_request_json:
  اجرای یک متد تلگرام که شامل دو پارامتر ورودی می‌شود
  • پارامتر اول: نام متد
  • پارامتر دوم: آرایه‌ای به همراه کلید و مقدار؛ ورودی‌های متدی که در پارامتر اول نوشته شده است.

ورژن 2:

• ساده تر شدن کد
• تبدیل نام تابع fktbs_request_json به fktbs_request با همان قابلیت‌های قبلی

تا آموزش بعدی و ساخت یک ربات کاربردی با TBS منتظر باشید.