Skip to content

بات‌ها

get_bot_info

این متد برای دریافت اطلاعات یک بات به کار می‌رود.

پارامتر:

  • bot: شناسه (GUID) یا نام‌کاربری بات مورد نظر.

نکته: تفاوتی ندارد که نام‌کاربری با @ نوشته شود یا بدون آن؛ کتابخانه هر دو حالت را می‌پذیرد.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        info = app.get_bot_info("@ShowInfoBot")
        print(info)

    except Exception as e:
        print(e)

get_service_info

این متد برای دریافت اطلاعات یک سرویس به کار می‌رود.

پارامتر:

  • service: شناسه (GUID) سرویس مورد نظر. باید با s0 شروع شده و ۳۲ کاراکتر باشد.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        info = app.get_service_info("s0abcdefghijklmnopqrstuvwxyz12")
        print(info)

    except Exception as e:
        print(e)

start_bot

این متد برای ارسال دستور /start به یک بات و راه‌اندازی آن به کار می‌رود.

پارامتر:

  • bot: شناسه (GUID) یا نام‌کاربری بات مورد نظر.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.start_bot("@TestBot")
        print(result)

    except Exception as e:
        print(e)

stop_bot

این متد برای متوقف کردن یک بات به کار می‌رود.

پارامتر:

  • bot: شناسه (GUID) یا نام‌کاربری بات مورد نظر.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.stop_bot("@TestBot")
        print(result)

    except Exception as e:
        print(e)

delete_bot_chat

این متد برای حذف تاریخچه چت با یک بات به کار می‌رود.

پارامترها:

  • bot: شناسه (GUID) یا نام‌کاربری بات مورد نظر.
  • last_deleted_message_id: شناسه آخرین پیام حذف‌شده.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.delete_bot_chat("@TestBot", last_deleted_message_id="12345678900")
        print(result)

    except Exception as e:
        print(e)

delete_service_chat

این متد برای حذف تاریخچه چت با یک سرویس به کار می‌رود.

پارامترها:

  • service: شناسه (GUID) سرویس مورد نظر. باید با s0 شروع شده و ۳۲ کاراکتر باشد.
  • last_deleted_message_id: شناسه آخرین پیام حذف‌شده.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.delete_service_chat("s0abcdefghijklmnopqrstuvwxyz12", last_deleted_message_id="12345678900")
        print(result)

    except Exception as e:
        print(e)