Skip to content

ابزارهای چت

send_chat_activity

این متد برای ارسال وضعیت فعالیت در چت (در حال تایپ، ضبط یا آپلود) است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کاربر.
  • activity: نوع فعالیت. مقادیر: Typing، Recording، Uploading. (پیش‌فرض: Typing)

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.send_chat_activity("u0abc123...", activity="Typing")
        print(result)

    except Exception as e:
        print(e)

click_keypad_button

این متد برای کلیک روی دکمه‌های کیپاد یک بات است.

پارامترها:

  • chat: GUID یا نام‌کاربری بات.
  • button_id: شناسه دکمه.

نکته: چت باید یک بات (b0) باشد.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.click_keypad_button("@MyBot", button_id="100")
        print(result)

    except Exception as e:
        print(e)

get_all_drafts

این متد برای دریافت تمام پیش‌نویس‌های ذخیره شده پیام‌ها است.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        drafts = app.get_all_drafts()
        print(drafts)

    except Exception as e:
        print(e)

upload_avatar

این متد برای آپلود تصویر پروفایل (آواتار) برای یک چت (خود، گروه یا کانال) است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری چت. همچنین می‌توان از me برای پروفایل خود استفاده کرد.
  • main_image: مسیر فایل یا داده‌های بایتی تصویر اصلی.
  • thumbnail_image: مسیر فایل یا داده‌های بایتی تصویر بندانگشتی. (پیش‌فرض: None - استفاده از تصویر اصلی)

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.upload_avatar(
            "me",
            main_image="/path/to/avatar.jpg"
        )
        print(result)

    except Exception as e:
        print(e)

get_avatars

این متد برای دریافت لیست آواتارهای یک چت است.

پارامتر:

  • chat: GUID، لینک یا نام‌کاربری چت. همچنین می‌توان از me برای پروفایل خود استفاده کرد.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        avatars = app.get_avatars("g0abc123...")
        print(avatars)

    except Exception as e:
        print(e)

delete_avatar

این متد برای حذف یک آواتار خاص از چت است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری چت.
  • avatar_id: شناسه آواتار مورد نظر.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.delete_avatar("me", avatar_id="avatar_123")
        print(result)

    except Exception as e:
        print(e)

delete_all_avatars

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

پارامتر:

  • chat: GUID، لینک یا نام‌کاربری چت.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.delete_all_avatars("g0abc123...")
        print(result)

    except Exception as e:
        print(e)

download_profile_picture

این متد برای دانلود تصویر پروفایل یک کاربر، گروه یا کانال است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری چت.
  • file_id: شناسه فایل برای دانلود مستقیم. (پیش‌فرض: None)
  • access_hash_rec: هش دسترسی فایل. (پیش‌فرض: None)
  • dc_id: شناسه دیتاسنتر. (پیش‌فرض: None)
  • save_as: مسیر ذخیره فایل. True برای ذخیره در مسیر فعلی، str برای مسیر دلخواه، None برای بازگرداندن بایت. (پیش‌فرض: None)
  • save_all: دانلود تمام آواتارها به جای آخرین مورد. (پیش‌فرض: False)

مثال‌ها:

  1. دریافت آخرین عکس پروفایل به صورت بایت:
Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        image_bytes = app.download_profile_picture("@Online_User")
        print(len(image_bytes))

    except Exception as e:
        print(e)
  1. ذخیره در مسیر دلخواه:
Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.download_profile_picture("@Online_User", save_as="/path/to/folder")
        print(result)

    except Exception as e:
        print(e)