Skip to content

مدیریت چت و لینک دعوت

join_chat

این متد برای عضویت در یک چت (گروه یا کانال) است. به صورت خودکار نوع چت را تشخیص داده و متد مناسب را فراخوانی می‌کند.

پارامتر:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.join_chat("https://rubika.ir/joing/ABC123")
        print(result)

    except Exception as e:
        print(e)

leave_chat

این متد برای خروج از یک چت (گروه یا کانال) است.

پارامتر:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.

مثال:

Python
from maxrubika import Messenger

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

    except Exception as e:
        print(e)

check_join

این متد برای بررسی عضویت یک کاربر یا بات در یک گروه یا کانال است. مقدار بازگشتی True یا False است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • member: GUID یا نام‌کاربری کاربر یا بات مورد نظر.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        is_member = app.check_join("g0abc123...", member="@Online_User")
        print(is_member)

    except Exception as e:
        print(e)

این متد برای ایجاد لینک دعوت برای یک گروه یا کانال است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • expire_time: مدت زمان اعتبار لینک به ثانیه. (پیش‌فرض: None - بدون انقضا)
  • request_needed: نیاز به تأیید درخواست عضویت. (پیش‌فرض: False)
  • title: عنوان سفارشی برای لینک دعوت. (پیش‌فرض: None)
  • usage_limit: حداکثر تعداد استفاده از لینک. (پیش‌فرض: 0 - نامحدود)

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        link = app.create_join_link(
            "g0abc123...",
            request_needed=True,
            title="لینک ویژه",
            usage_limit=10
        )
        print(link)

    except Exception as e:
        print(e)

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

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • creator: GUID یا نام‌کاربری سازنده لینک برای فیلتر. (پیش‌فرض: None)

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        links = app.get_join_links("g0abc123...")
        print(links)

    except Exception as e:
        print(e)

get_join_requests

این متد برای دریافت لیست درخواست‌های عضویت در یک گروه یا کانال است. به صورت خودکار تمام صفحات را پیمایش می‌کند.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • show_user_guids: نمایش GUID کاربران در خروجی. (پیش‌فرض: False)

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        requests = app.get_join_requests("g0abc123...")
        print(requests)

    except Exception as e:
        print(e)

accept_join_request

این متد برای پذیرفتن یک درخواست عضویت در گروه یا کانال است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • user: GUID یا نام‌کاربری کاربر درخواست‌دهنده.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.accept_join_request("g0abc123...", user="@NewUser")
        print(result)

    except Exception as e:
        print(e)

reject_join_request

این متد برای رد کردن یک درخواست عضویت در گروه یا کانال است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • user: GUID یا نام‌کاربری کاربر درخواست‌دهنده.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.reject_join_request("g0abc123...", user="@SpamUser")
        print(result)

    except Exception as e:
        print(e)

accept_all_join_requests

این متد برای پذیرفتن تمام درخواست‌های عضویت در یک گروه یا کانال به صورت یکجا است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • exclude: GUID یا نام‌کاربری کاربرانی که نباید پذیرفته شوند. (پیش‌فرض: None)

مثال:

Python
from maxrubika import Messenger

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

    except Exception as e:
        print(e)