تنظیمات چت

---

mute_chat

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

پارامترها:

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

مثال‌ها:

1. بی‌صدای دائمی:

Python

from maxrubika import Messenger

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

    except Exception as e:
        print(e)

1. بی‌صدا برای ۲ ساعت:

Python

from datetime import timedelta
from maxrubika import Messenger

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

    except Exception as e:
        print(e)

---

unmute_chat

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

پارامتر:

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

مثال:

Python

from maxrubika import Messenger

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

    except Exception as e:
        print(e)

---

pin_chat

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

پارامتر:

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

مثال:

Python

from maxrubika import Messenger

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

    except Exception as e:
        print(e)

---

unpin_chat

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

پارامتر:

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

مثال:

Python

from maxrubika import Messenger

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

    except Exception as e:
        print(e)

---

pin_chat_in_folder

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

پارامترها:

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

مثال:

Python

from maxrubika import Messenger

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

    except Exception as e:
        print(e)

---

unpin_chat_in_folder

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

پارامترها:

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

مثال:

Python

from maxrubika import Messenger

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

    except Exception as e:
        print(e)

---

archive_chat

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

پارامتر:

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

مثال:

Python

from maxrubika import Messenger

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

    except Exception as e:
        print(e)

---

unarchive_chat

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

پارامتر:

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

مثال:

Python

from maxrubika import Messenger

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

    except Exception as e:
        print(e)

---

seen_chats

این متد برای علامت‌گذاری چند چت به عنوان دیده‌شده است.

پارامتر:

• seen_list: دیکشنری شامل GUID چت‌ها و آخرین شناسه پیام دیده‌شده.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.seen_chats({
            "u0abc123...": "123456",
            "g0xyz789...": "789012"
        })
        print(result)

    except Exception as e:
        print(e)

---

set_chat_protected_content

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

پارامترها:

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

مثال:

Python

from maxrubika import Messenger

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

    except Exception as e:
        print(e)

---

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 Messenger

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

    except Exception as e:
        print(e)

---

set_chat_use_time

این متد برای ارسال زمان استفاده از چت به سرور است. این کار به سرور کمک می‌کند رفتار طبیعی کاربر را تشخیص دهد.

پارامترها:

• chat: GUID، لینک یا نام‌کاربری چت.
• use_time: زمان سپری‌شده در چت به میلی‌ثانیه.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.set_chat_use_time("u0abc123...", use_time=5000)
        print(result)

    except Exception as e:
        print(e)

---

delete_chat_history

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

پارامتر:

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

مثال:

Python

from maxrubika import Messenger

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

    except Exception as e:
        print(e)

---

report_chat

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

پارامترها:

• chat: GUID، لینک یا نام‌کاربری چت.
• report_type: نوع گزارش.
• description: توضیحات اضافی. (پیش‌فرض: None)

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.report_chat(
            "u0abc123...",
            report_type="Spam",
            description="کاربر اسپمر"
        )
        print(result)

    except Exception as e:
        print(e)

---

set_ask_spam

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

پارامترها:

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

مثال:

Python

from maxrubika import Messenger

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

    except Exception as e:
        print(e)

---

بازگشت به صفحه قبل