📖 کتابچه فارسی

راهنمای فارسی پایروبله!

مقدمه

به راهنمای فارسی پایروبله خوش آمدید. اینجا از صفر شروع می کنیم و به صورت کامل نحوه کارکرد ربات های بله و شروع با پایروبله رو به شما آموزش می دیم!

پیش نیاز شروع با پایروبله

برای شروع نوشتن ربات با کتابخانه پایروبله:

لازم است که

  • پایتون را تا حد خوبی بلد باشید

  • درک کاملی از نحوه کارکرد کتابخانه های پایتون داشته باشید

بهتر است که

  • پایتون شئ گرا را درک کرده باشید

  • نحوه کارکرد API را درک کرده باشید

  • توانایی مطالعه مستندات و مطرح کردن سوال در فروم را داشته باشید

فهم نحوه کارکرد ربات های بله

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

دریافت توکن از بات فادر

برای ایجاد یک ربات جدید در پیامرسان بله، باید در بات فادر یک بازوی جدید ثبت کنید.

دستور /newbot را ارسال کنید و ربات خود را ایجاد کنید و توکن را دریافت کنید.

این توکن مثل رمزعبور برای ربات شماست. لزومی ندارد آن را جایی به جز در کد وارد کنید و به کسی بدهید.

شروع با پایروبله

در این قسمت می خواهیم به استفاده از توکنی که دریافت کرده ایم یک ربات ساده ایجاد کنیم.

نصب پایروبله

ابتدا باید کتابخانه پایروبله را نصب کنید.

با کمک دستور

pip install pyrobale

کتابخانه را نصب کنید.

نوشتن کد

حالا یک فایل با پسوند .py ایجاد کنید.

در خط اول، باید کتابخانه پایروبله را وارد کد کنید پس دستور زیر را داخل فایل می نویسید

import pyrobale

سپس با استفاده از ایجاد متغیر توکن خود را در کد ذخیره می کنیم

token = "YOUR_TOKEN"

به جای YOUR_TOKEN توکنی که از بات فادر دریافت کردید رو وارد کنید.

سپس نیاز به این داریم که یک کارخواه (کلاینت) ایجاد کنیم تا با بله در ارتباط باشد. پس از کد زیر استفاده می کنیم تا کلاینت رو با توکن شما ایجاد کنیم.

client = pyrobale.Client(token)

حالا ربات ما ایجاد شده و در مرحله بعدی باید رفتار ربات رو تعیین کنیم.

ابتدا می خواهیم اگر کسی برای ربات ما دستور /start را ارسال کرد، به او سلام کنیم.

پس از دستور زیر استفاده می کنیم تا دستور start را برای ربات تعریف کنیم.

@client.on_command("start")

سپس دقیقا زیر همین خط، یک تابع ایجاد می کنیم تا کد های خود را بنویسیم.

async def start(message: pyrobale.Message):

تابع ما یک پارامتر message می گیرد که این را خود پایروبله به تابع شما می دهد.

Note

نکته: شما می توانید بسته به نیاز خود کلیدواژه async را استفاده کنید یا نکنید.

بعد از ایجاد تابع، باید در جواب به پیام کاربر، به او سلام کنیم، پس از دستور زیر استفاده می کنیم

await message.reply("سلام!")

Note

نکته: شما می توانید بسته به نیاز خود کلیدواژه await را استفاده کنید یا نکنید، در صورتی که پیش از کلیدواژه def کلمه async را به کار بردید، پیشنهاد می کنم اینجا هم از await استفاده کنید.

حال ربات ما آماده ست!

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

client.run()

فایل نهایی چیزی شبیه به این خواهد بود:

import pyrobale

token = "YOUR_TOKEN"
client = pyrobale.Client(token)

@client.on_command("start")
async def start(message: pyrobale.Message):
    await message.reply("سلام!")

client.run()

و فایل را ذخیره و اجرا کنید.

حالا ربات ساده شما آماده ست!