Skip to content

تنظیمات چت

mute_chat

این متد برای بی‌صدا کردن (Mute) یک چت است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری چت.
  • duration: مدت زمان بی‌صدا کردن به ثانیه (حداقل ۱۸۰۰ ثانیه / ۳۰ دقیقه) یا timedelta. (پیش‌فرض: None - بی‌صدای دائمی)

مثال‌ها:

  1. بی‌صدای دائمی:
Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.mute_chat("g0abc123...")
    print(result)
  1. بی‌صدا برای ۲ ساعت:
Python
from datetime import timedelta
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.mute_chat("g0abc123...", duration=timedelta(hours=2))
    print(result)

unmute_chat

این متد برای لغو بی‌صدا کردن (Unmute) یک چت است.

پارامتر:

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

مثال:

Python
from maxrubika import Shad

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

pin_chat

این متد برای سنجاق کردن (Pin) یک چت در بالای لیست چت‌ها است.

پارامتر:

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

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.pin_chat("u0abc123...")
    print(result)

unpin_chat

این متد برای برداشتن سنجاق (Unpin) یک چت است.

پارامتر:

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

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.unpin_chat("u0abc123...")
    print(result)

pin_chat_in_folder

این متد برای سنجاق کردن یک چت در یک پوشه خاص است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری چت.
  • folder_id: شناسه پوشه.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.pin_chat_in_folder("u0abc123...", folder_id="folder_123")
    print(result)

unpin_chat_in_folder

این متد برای برداشتن سنجاق یک چت از یک پوشه خاص است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری چت.
  • folder_id: شناسه پوشه.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.unpin_chat_in_folder("u0abc123...", folder_id="folder_123")
    print(result)

archive_chat

این متد برای آرشیو کردن یک چت است.

پارامتر:

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

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.archive_chat("u0abc123...")
    print(result)

unarchive_chat

این متد برای خارج کردن یک چت از آرشیو است.

پارامتر:

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

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.unarchive_chat("u0abc123...")
    print(result)

set_chat_protected_content

این متد برای تنظیم محتوای محافظت‌شده (جلوگیری از اسکرین‌شات و ذخیره) در گروه یا کانال است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • enabled: True برای فعال‌سازی، False برای غیرفعال‌سازی.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.set_chat_protected_content("g0abc123...", enabled=True)
    print(result)

set_chat_auto_delete

این متد برای تنظیم حذف خودکار پیام‌ها در گروه یا کانال است.

پارامترها:

  • chat: یک GUID/لینک/نام‌کاربری یا لیستی از آن‌ها.
  • auto_delete: مدت زمان حذف خودکار. مقادیر قابل قبول:
    • عدد: ۱ تا ۳۶۵ (روز)
    • رشته: 1m تا 60m، 1h تا 24h، 1d تا 365d، 1w تا 52w، 1y، off
    • کلمات: day, week, month, year, never, disabled

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.set_chat_auto_delete("g0abc123...", auto_delete="7d")
    print(result)

delete_chat_history

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

پارامتر:

  • chat: GUID، لینک یا نام‌کاربری چت (کاربر یا گروه). برای کانال‌ها قابل استفاده نیست.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.delete_chat_history("u0abc123...")
    print(result)

set_ask_spam

این متد برای انجام عملیات روی یک درخواست اسپم معلق است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری کاربر، گروه یا کانال.
  • action: عملیات مورد نظر:
    • برای کاربر (u0): AddToContact، BlockUser، Cancel.
    • برای گروه/کانال (g0/c0): ReportAndLeave.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.set_ask_spam("u0abc123...", action="BlockUser")
    print(result)

upload_avatar

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

پارامترها:

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

مثال:

Python
from maxrubika import Shad

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

get_avatars

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

پارامتر:

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

مثال:

Python
from maxrubika import Shad

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

delete_avatar

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

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری چت. همچنین می‌توان از me، cloud، self یا myself برای پروفایل خود استفاده کرد.
  • avatar_id: شناسه آواتار مورد نظر.

مثال:

Python
from maxrubika import Shad

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

delete_all_avatars

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

پارامتر:

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

مثال:

Python
from maxrubika import Shad

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