Skip to content

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

join_chat

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

پارامتر:

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

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.join_chat("https://shad.ir/joing/ABC123")
    print(result)

leave_chat

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

پارامتر:

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

مثال:

Python
from maxrubika import Shad

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

check_join

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

پارامترها:

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

مثال:

Python
from maxrubika import Shad

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

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

پارامترها:

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

مثال:

Python
from maxrubika import Shad

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

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

پارامترها:

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

نکته: حداقل یکی از پارامترهای title، expire_time، request_needed یا usage_limit باید ارائه شود.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.edit_join_link(
        "g0abc123...",
        join_link="https://shad.ir/joing/ABC123",
        title="لینک جدید",
        usage_limit=20
    )
    print(result)

این متد برای لغو (باطل کردن) یک لینک دعوت در گروه یا کانال است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • join_link: لینک دعوتی که باید لغو شود.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.revoke_join_link(
        "g0abc123...",
        join_link="https://shad.ir/joing/ABC123"
    )
    print(result)

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

پارامترها:

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

مثال:

Python
from maxrubika import Shad

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

get_join_requests

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

پارامترها:

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

مثال:

Python
from maxrubika import Shad

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

accept_join_request

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

پارامترها:

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

مثال:

Python
from maxrubika import Shad

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

reject_join_request

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

پارامترها:

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

مثال:

Python
from maxrubika import Shad

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

accept_all_join_requests

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

پارامترها:

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

مثال:

Python
from maxrubika import Shad

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