مستندات کتابخانه riopy

pip install riopy

import riopy
print(riopy.__version__)   # 0.1.1 یا بالاتر

import riopy

bot = riopy.Bot("توکن_بات_شما")

@bot.on_message()
def handle_message(update):
    if update.new_message.text == "/start":
        bot.send_message(
            chat_id=update.chat_id,
            text="سلام! به بات من خوش آمدی 👋"
        )

if __name__ == "__main__":
    bot.polling()

from riopy import Bot
bot = Bot("token")

me = bot.get_me()
print(me.bot_title)   # نام بات
print(me.bot_id)      # شناسه بات

message_id = bot.send_message(
    chat_id="شناسه_چت",
    text="متن پیام",
    disable_notification=False,          # (اختیاری)
    reply_to_message_id="شناسه_پیام",    # (اختیاری) پاسخ به پیام خاص
    chat_keypad=...,                      # (اختیاری) کیبورد پایین صفحه
    inline_keypad=...                      # (اختیاری) کیبورد شیشه‌ای
)

message_id = bot.send_poll(
    chat_id="شناسه_چت",
    question="آیا این کتابخانه مفید است؟",
    options=["بله", "خیر", "نظری ندارم"]
)

# مسدود کردن کاربر در گروه/کانال
bot.ban_chat_member("chat_id", "user_id")

# رفع مسدودیت کاربر
bot.unban_chat_member("chat_id", "user_id")

@bot.on_message()
def my_handler(update):
    # پردازش پیام جدید
    pass

bot.polling(interval=2.0)   # بررسی هر ۲ ثانیه

from flask import Flask, request
import riopy

app = Flask(__name__)
bot = riopy.Bot("token")

@app.route("/webhook", methods=["POST"])
def webhook():
    data = request.json
    update = riopy.types.Update.from_dict(data.get("update"))
    # پردازش update مشابه قبل
    return "OK"

keypad = {
    "rows": [
        {
            "buttons": [
                {"id": "btn1", "type": "Simple", "button_text": "دکمه ۱"},
                {"id": "btn2", "type": "Simple", "button_text": "دکمه ۲"}
            ]
        }
    ],
    "resize_keyboard": True
}

bot.send_message(
    chat_id=chat_id,
    text="یک دکمه انتخاب کنید:",
    chat_keypad=keypad,
    chat_keypad_type=riopy.types.ChatKeypadTypeEnum.New
)

from riopy.exceptions import APIError, InvalidTokenError

try:
    me = bot.get_me()
except InvalidTokenError:
    print("توکن اشتباه است!")
except APIError as e:
    print(f"خطای API: {e}")