Skip to content

تنظیمات

get_privacy_setting

این متد برای دریافت تنظیمات حریم خصوصی فعلی کاربر به کار می‌رود.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        privacy = app.get_privacy_setting()
        print(privacy)

    except Exception as e:
        print(e)

get_notification_setting

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

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        notifications = app.get_notification_setting()
        print(notifications)

    except Exception as e:
        print(e)

set_notification

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

پارامترها:

  • user_notification: فعال/غیرفعال کردن اعلان کاربران.
  • user_message_preview: نمایش/عدم نمایش پیش‌نمایش پیام کاربران.
  • group_notification: فعال/غیرفعال کردن اعلان گروه‌ها.
  • group_message_preview: نمایش/عدم نمایش پیش‌نمایش پیام گروه‌ها.
  • channel_notification: فعال/غیرفعال کردن اعلان کانال‌ها.
  • channel_message_preview: نمایش/عدم نمایش پیش‌نمایش پیام کانال‌ها.
  • in_app_sound: فعال/غیرفعال کردن صدای درون برنامه.
  • in_app_preview: فعال/غیرفعال کردن پیش‌نمایش درون برنامه.
  • new_contacts: فعال/غیرفعال کردن اعلان مخاطبین جدید.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.set_notification(
            user_notification=True,
            group_notification=False,
            in_app_sound=True
        )
        print(result)

    except Exception as e:
        print(e)

set_setting

این متد برای تنظیم حریم خصوصی و تنظیمات حذف خودکار به کار می‌رود.

پارامترهای حریم خصوصی (مقادیر قابل قبول: Everybody، MyContacts، Nobody):

  • show_my_last_online: چه کسانی آخرین بازدید شما را ببینند.
  • show_my_phone_number: چه کسانی شماره تلفن شما را ببینند.
  • show_my_profile_photo: چه کسانی عکس پروفایل شما را ببینند.
  • link_forward_message: چه کسانی لینک پیام‌های شما را فوروارد کنند.
  • can_join_chat_by: چه کسانی بتوانند از طریق لینک به چت شما ملحق شوند.
  • show_my_birth_date: چه کسانی تاریخ تولد شما را ببینند.
  • can_called_by: چه کسانی بتوانند با شما تماس بگیرند.

پارامترهای استثنا (exceptions):

هر کدام می‌توانند یک دیکشنری با کلیدهای include_users و exclude_users باشند.

پارامترهای حذف خودکار:

  • auto_delete_messages: مدت زمان حذف خودکار پیام‌ها.
  • inactive_account_delete: حذف حساب پس از چند ماه عدم فعالیت. (مقادیر: 3، 6، 12، 24)

مثال‌ها:

  1. تنظیم آخرین بازدید فقط برای مخاطبین:
Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.set_setting(show_my_last_online="MyContacts")
        print(result)

    except Exception as e:
        print(e)
  1. تنظیم با استثنا:
Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.set_setting(
            show_my_last_online="Nobody",
            show_my_last_online_exceptions={
                "include_users": ["u0abc123..."]
            }
        )
        print(result)

    except Exception as e:
        print(e)

edit_show_last_online

این متد میانبری برای تنظیم نمایش آخرین بازدید است.

پارامترها:

  • setting: Everybody، MyContacts یا Nobody.
  • exceptions: دیکشنری استثناها (include_users و exclude_users).

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.edit_show_last_online("MyContacts")
        print(result)

    except Exception as e:
        print(e)

edit_show_phone_number

این متد میانبری برای تنظیم نمایش شماره تلفن است.

پارامترها:

  • setting: Everybody، MyContacts یا Nobody.
  • exceptions: دیکشنری استثناها.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.edit_show_phone_number("Nobody")
        print(result)

    except Exception as e:
        print(e)

edit_show_profile_photo

این متد میانبری برای تنظیم نمایش عکس پروفایل است.

پارامترها:

  • setting: Everybody، MyContacts یا Nobody.
  • exceptions: دیکشنری استثناها.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.edit_show_profile_photo("MyContacts")
        print(result)

    except Exception as e:
        print(e)

edit_show_birthday

این متد میانبری برای تنظیم نمایش تاریخ تولد است.

پارامترها:

  • setting: Everybody، MyContacts یا Nobody.
  • exceptions: دیکشنری استثناها.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.edit_show_birthday("Nobody")
        print(result)

    except Exception as e:
        print(e)

edit_can_join_chat_by

این متد میانبری برای تنظیم امکان ملحق شدن از طریق لینک است.

پارامترها:

  • setting: Everybody، MyContacts یا Nobody.
  • exceptions: دیکشنری استثناها.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.edit_can_join_chat_by("MyContacts")
        print(result)

    except Exception as e:
        print(e)

edit_can_called_by

این متد میانبری برای تنظیم امکان تماس گرفتن با شما است.

پارامترها:

  • setting: Everybody، MyContacts یا Nobody.
  • exceptions: دیکشنری استثناها.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.edit_can_called_by("Nobody")
        print(result)

    except Exception as e:
        print(e)

auto_delete_account

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

پارامتر:

  • setting: تعداد ماه‌ها. مقادیر قابل قبول: 3، 6، 12 یا 24.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.auto_delete_account(6)
        print(result)

    except Exception as e:
        print(e)

update_my_name

این متد برای به‌روزرسانی نام و نام خانوادگی کاربر به کار می‌رود.

پارامترها:

  • first_name: نام جدید. (حداکثر ۳۰ کاراکتر)
  • last_name: نام خانوادگی جدید. (حداکثر ۵۰ کاراکتر)

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.update_my_name(first_name="علی", last_name="حسینی")
        print(result)

    except Exception as e:
        print(e)

update_my_username

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

پارامتر:

  • username: نام‌کاربری جدید. (حداقل ۷ و حداکثر ۳۲ کاراکتر، فقط حروف انگلیسی، اعداد و زیرخط)

نکته: نام‌کاربری نمی‌تواند با عدد یا زیرخط شروع شود یا به زیرخط ختم شود و باید حداقل شامل یک حرف باشد.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.update_my_username("new_username")
        print(result)

    except Exception as e:
        print(e)

update_my_bio

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

پارامتر:

  • bio: متن بیوگرافی جدید. (حداکثر ۱۵۰ کاراکتر)

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.update_my_bio("این بیوگرافی من است.")
        print(result)

    except Exception as e:
        print(e)

update_my_birthday

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

پارامتر:

  • birthday: تاریخ تولد با فرمت YYYY-MM-DD.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.update_my_birthday("2000-05-20")
        print(result)

    except Exception as e:
        print(e)

update_my_profile

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

پارامترها:

  • first_name: نام جدید.
  • last_name: نام خانوادگی جدید.
  • bio: بیوگرافی جدید.
  • birthday: تاریخ تولد با فرمت YYYY-MM-DD.
  • location: اطلاعات موقعیت مکانی شامل longitude، latitude و map_view.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.update_my_profile(
            first_name="علی",
            bio="برنامه‌نویس پایتون"
        )
        print(result)

    except Exception as e:
        print(e)

get_two_passcode_status

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

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        status = app.get_two_passcode_status()
        print(status)

    except Exception as e:
        print(e)

set_two_step_verification

این متد برای تنظیم تأیید دو مرحله‌ای به کار می‌رود.

پارامترها:

  • password: رمز عبور فعلی.
  • hint: راهنمایی برای یادآوری رمز. (پیش‌فرض: None)
  • recovery_email: ایمیل بازیابی. (پیش‌فرض: None)

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.set_two_step_verification(
            password="current_password",
            hint="رمز من"
        )
        print(result)

    except Exception as e:
        print(e)

check_two_step_passcode

این متد برای بررسی صحت رمز تأیید دو مرحله‌ای به کار می‌رود.

پارامتر:

  • password: رمز تأیید دو مرحله‌ای.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.check_two_step_passcode("my_password")
        print(result)

    except Exception as e:
        print(e)

turn_off_two_step

این متد برای غیرفعال کردن تأیید دو مرحله‌ای به کار می‌رود.

پارامتر:

  • password: رمز تأیید دو مرحله‌ای فعلی.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.turn_off_two_step("my_password")
        print(result)

    except Exception as e:
        print(e)

change_password

این متد برای تغییر رمز عبور حساب به کار می‌رود.

پارامترها:

  • password: رمز عبور فعلی.
  • new_password: رمز عبور جدید.
  • new_hint: راهنمایی جدید برای رمز.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.change_password(
            password="old_pass",
            new_password="new_pass",
            new_hint="راهنمایی جدید"
        )
        print(result)

    except Exception as e:
        print(e)

recovery_email

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

پارامترها:

  • password: رمز عبور فعلی.
  • recovery_email: ایمیل بازیابی.

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

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.recovery_email(
            password="my_password",
            recovery_email="example@email.com"
        )
        print(result)

    except Exception as e:
        print(e)

request_change_phone_number

این متد برای درخواست تغییر شماره تلفن حساب به کار می‌رود.

پارامتر:

  • new_phone_number: شماره تلفن جدید.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.request_change_phone_number("09123456789")
        print(result)

    except Exception as e:
        print(e)

verify_change_phone_number

این متد برای تأیید تغییر شماره تلفن با کد دریافتی به کار می‌رود.

پارامترها:

  • code: کد تأیید ارسال شده.
  • hash: هش دریافتی از متد request_change_phone_number.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.verify_change_phone_number(
            code="12345",
            hash="hash_from_request"
        )
        print(result)

    except Exception as e:
        print(e)

get_my_sessions

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

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        sessions = app.get_my_sessions()
        print(sessions)

    except Exception as e:
        print(e)

get_unconfirmed_sessions

این متد برای دریافت نشست‌های تأیید نشده (در انتظار تأیید) حساب کاربری به کار می‌رود.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        pending = app.get_unconfirmed_sessions()
        print(pending)

    except Exception as e:
        print(e)

confirm_unconfirmed_session

این متد برای تأیید یک نشست در انتظار به کار می‌رود.

پارامتر:

  • unconfirmed_session_key: کلید نشست تأیید نشده.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.confirm_unconfirmed_session("session_key_123")
        print(result)

    except Exception as e:
        print(e)

deny_unconfirmed_session

این متد برای رد یک نشست در انتظار به کار می‌رود.

پارامتر:

  • unconfirmed_session_key: کلید نشست تأیید نشده.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.deny_unconfirmed_session("session_key_123")
        print(result)

    except Exception as e:
        print(e)

terminate_session

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

پارامتر:

  • session_key: کلید نشست.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.terminate_session("session_key_123")
        print(result)

    except Exception as e:
        print(e)

terminate_other_sessions

این متد برای پایان دادن به تمام نشست‌های دیگر (به جز نشست فعلی) به کار می‌رود.

مثال:

Python
from maxrubika import Messenger

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

    except Exception as e:
        print(e)

register_device

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

پارامتر:

  • device_model: نام مدل دستگاه سفارشی. (پیش‌فرض: None - تشخیص خودکار)

مثال:

Python
from maxrubika import Messenger

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

    except Exception as e:
        print(e)

logout

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

توجه: پس از اجرا، باید حرف y را برای تأیید وارد نمایید.

مثال:

Python
from maxrubika import Messenger

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

    except Exception as e:
        print(e)

delete_account

این متد برای درخواست حذف دائمی حساب روبیکا به کار می‌رود.

توجه: پس از اجرا، یک پیامک تأیید حاوی لینک حذف حساب به شماره شما ارسال خواهد شد.

مثال:

Python
from maxrubika import Messenger

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

    except Exception as e:
        print(e)

get_folders

این متد برای دریافت لیست پوشه‌ها (Folders) به کار می‌رود.

پارامتر:

  • last_state: آخرین وضعیت برای دریافت پوشه‌ها. (پیش‌فرض: زمان فعلی منهای ۱۵۰ ثانیه)

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        folders = app.get_folders()
        print(folders)

    except Exception as e:
        print(e)

get_suggested_folders

این متد برای دریافت پوشه‌های پیشنهادی کاربر به کار می‌رود.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        suggested = app.get_suggested_folders()
        print(suggested)

    except Exception as e:
        print(e)

add_folder

این متد برای افزودن یک پوشه جدید برای سازمان‌دهی چت‌ها به کار می‌رود.

پارامترها:

  • name: نام پوشه.
  • include_chats: چت‌هایی که در پوشه قرار گیرند (GUID، لینک یا نام‌کاربری).
  • exclude_chats: چت‌هایی که از پوشه مستثنی شوند.
  • include_chat_types: انواع چت برای شمول (مانند User، Group، Channel، Bot).
  • exclude_chat_types: انواع چت برای استثنا.
  • is_add_to_top: افزودن پوشه به بالای لیست. (پیش‌فرض: True)
  • suggestion_folder_id: شناسه پوشه پیشنهادی.
  • folder_id: شناسه پوشه.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.add_folder(
            name="دوستان",
            include_chats=["@User1", "@User2"]
        )
        print(result)

    except Exception as e:
        print(e)

delete_folder

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

پارامتر:

  • folder_id: شناسه پوشه.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.delete_folder("folder_id_123")
        print(result)

    except Exception as e:
        print(e)

reorder_folder

این متد برای تغییر ترتیب پوشه‌ها به کار می‌رود.

پارامتر:

  • folder_ids: یک شناسه یا لیستی از شناسه‌های پوشه‌ها به ترتیب جدید.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.reorder_folder(["id3", "id1", "id2"])
        print(result)

    except Exception as e:
        print(e)

add_saved_music_playlist

این متد برای افزودن آهنگ به لیست موسیقی ذخیره شده در پروفایل به کار می‌رود.

پارامترها:

  • files: یک مسیر فایل یا لیستی از مسیرهای فایل‌های موسیقی.
  • file_inlines: لیست دیکشنری‌های file_inline از پیش آپلود شده.
  • time: مدت زمان سفارشی به ثانیه. (در صورت عدم ارسال، تشخیص خودکار)
  • performer: نام خواننده سفارشی. (در صورت عدم ارسال، تشخیص خودکار)
  • file_name: نام فایل سفارشی. (در صورت عدم ارسال، از نام اصلی فایل استفاده می‌شود)

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.add_saved_music_playlist(
            files=["song1.mp3", "song2.mp3"]
        )
        print(result)

    except Exception as e:
        print(e)

set_saved_music_playlist

این متد برای جایگزینی کامل لیست موسیقی ذخیره شده در پروفایل به کار می‌رود.

پارامترها:

  • files: یک مسیر فایل یا لیستی از مسیرهای فایل‌های موسیقی.
  • file_inlines: لیست دیکشنری‌های file_inline از پیش آپلود شده.
  • time: مدت زمان سفارشی به ثانیه. (در صورت عدم ارسال، تشخیص خودکار)
  • performer: نام خواننده سفارشی. (در صورت عدم ارسال، تشخیص خودکار)
  • file_name: نام فایل سفارشی. (در صورت عدم ارسال، از نام اصلی فایل استفاده می‌شود)

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.set_saved_music_playlist(
            files=["song1.mp3", "song2.mp3"]
        )
        print(result)

    except Exception as e:
        print(e)

delete_saved_music_playlist

این متد برای حذف آهنگ‌ها از لیست موسیقی ذخیره شده به کار می‌رود.

پارامتر:

  • position: موقعیت آهنگ برای حذف. اگر None باشد، تمام آهنگ‌ها حذف می‌شوند. (پیش‌فرض: None)

مثال‌ها:

حذف یک آهنگ خاص:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        result = app.delete_saved_music_playlist(position=1)
        print(result)

    except Exception as e:
        print(e)

حذف تمام آهنگ‌ها:

Python
from maxrubika import Messenger

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

    except Exception as e:
        print(e)

upgrade_to_api6

این متد برای ارتقاء از API نسخه ۵ به نسخه ۶ با تنظیم کلید عمومی RSA به کار می‌رود.

پارامترها:

  • save_as: در صورت True بودن، auth و private_key در فایل JSON ذخیره می‌شود. (پیش‌فرض: True)
  • file_name: نام فایل سفارشی برای ذخیره. (پیش‌فرض: maxrubika_{auth[:10]})

نکته: این متد فقط با api_version = 5 کار می‌کند.

مثال:

Python
from maxrubika import Messenger

with Messenger(auth = "ahkjbsawthnh...", api_version=5) as app:
    try:
        result = app.upgrade_to_api6()
        print(result)

    except Exception as e:
        print(e)