دریافت و جستجوی پیام

get_message_info

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

پارامترها:

chat: شناسه (GUID)، لینک یا نام‌کاربری چت.
message_id: شناسه پیام مورد نظر.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        info = app.get_message_info("@Online_User", message_id="12345678900")
        print(info)

    except Exception as e:
        print(e)

get_messages

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

پارامترها:

chat: شناسه (GUID)، لینک یا نام‌کاربری چت.
types: نوع یا لیستی از انواع پیام برای فیلتر. انواع قابل قبول:
- text, image, video, video_message, voice, music, file, gif
- live, location, poll, contact, event, edited, forwarded
- sticker, me, bots, users
- همچنین می‌توانید GUID یا نام‌کاربری یک عضو را برای فیلتر پیام‌های او وارد کنید.

نکته: فیلتر contact تنها در چت‌های خصوصی قابل استفاده است.

مثال‌ها:

دریافت تمام پیام‌ها:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        messages = app.get_messages("https://rubika.ir/joing/JGDJDBDJ0SRHELBQEBMZQFTPTKWSHDLCD")
        print(messages)

    except Exception as e:
        print(e)

دریافت فقط تصاویر و فقط ویدیو:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        images = app.get_messages("https://rubika.ir/joing/JGDJDBDJ0SRHELBQEBMZQFTPTKWSHDLCD", types=["image", "vodeo"])
        print(images)

    except Exception as e:
        print(e)

دریافت پیام‌های یک کاربر خاص:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        user_msgs = app.get_messages("https://rubika.ir/joing/JGDJDBDJ0SRHELBQEBMZQFTPTKWSHDLCD", types="u0xyz789...")
        print(user_msgs)

    except Exception as e:
        print(e)

get_all_messages

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

پارامترها:

chat: شناسه (GUID)، لینک یا نام‌کاربری چت.
show_message_ids: در صورت True بودن، شناسه پیام‌ها در خروجی نمایش داده می‌شود. (پیش‌فرض: False)

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

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        all_msgs = app.get_all_messages("u0abc123...")
        print(all_msgs)

    except Exception as e:
        print(e)

get_first_message

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

پارامتر:

chat: شناسه (GUID)، لینک یا نام‌کاربری چت.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        first = app.get_first_message("@MyGroup")
        print(first)

    except Exception as e:
        print(e)

get_first_messages

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

پارامترها:

chat: شناسه (GUID)، لینک یا نام‌کاربری چت.
limit: حداکثر تعداد پیام. (حداکثر ۱۰۰، پیش‌فرض: ۱۰۰)

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        first_msgs = app.get_first_messages("@MyGroup", limit=50)
        print(first_msgs)

    except Exception as e:
        print(e)

get_last_message

این متد برای دریافت آخرین پیام یک چت است.

پارامتر:

chat: شناسه (GUID)، لینک یا نام‌کاربری چت.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        last = app.get_last_message("Cipher")
        print(last)

    except Exception as e:
        print(e)

get_last_messages

این متد برای دریافت آخرین پیام‌های یک چت تا سقف مشخص است.

پارامترها:

chat: شناسه (GUID)، لینک یا نام‌کاربری چت.
limit: حداکثر تعداد پیام. (حداکثر ۱۰۰، پیش‌فرض: ۱۰۰)

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        last_msgs = app.get_last_messages("Cipher", limit=20)
        print(last_msgs)

    except Exception as e:
        print(e)

get_messages_by_id

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

پارامترها:

chat: شناسه (GUID)، لینک یا نام‌کاربری چت.
message_ids: یک شناسه یا لیستی از شناسه‌های پیام.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        msgs = app.get_messages_by_id("https://rubika.ir/joing/CHAT123", message_ids=["12345678099", "45612378900", "12288762148"])
        print(msgs)

    except Exception as e:
        print(e)

get_messages_interval

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

پارامترها:

chat: شناسه (GUID)، لینک یا نام‌کاربری چت.
middle_message_id: شناسه پیام میانی.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        interval = app.get_messages_interval("u0abc123...", middle_message_id="14523674102")
        print(interval)

    except Exception as e:
        print(e)

get_messages_updates

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

پارامترها:

chat: شناسه (GUID)، لینک یا نام‌کاربری چت.
state: وضعیت زمانی برای دریافت به‌روزرسانی‌ها. (پیش‌فرض: ۱۵۰ ثانیه قبل از زمان فعلی)

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        updates = app.get_messages_updates("Undefined")
        print(updates)

    except Exception as e:
        print(e)

get_chat_messages

این متد برای دریافت پیام‌های چت با قابلیت فیلتر و صفحه‌بندی است.

پارامترها:

chat: شناسه (GUID)، لینک یا نام‌کاربری چت.
sort: جهت مرتب‌سازی. FromMax یا FromMin. (پیش‌فرض: FromMin)
filter_type: فیلتر بر اساس نوع. مقادیر: Voice, File, Music, Gif, Media, Link. (پیش‌فرض: None)
limit: حداکثر تعداد پیام. (پیش‌فرض: None - دریافت همه)

مثال‌ها:

دریافت پیام‌ها از جدیدترین:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        msgs = app.get_chat_messages("u0abc123...", sort="FromMax", limit=50)
        print(msgs)

    except Exception as e:
        print(e)

دریافت فقط فایل‌ها:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        files = app.get_chat_messages("@MyChannel", filter_type="File")
        print(files)

    except Exception as e:
        print(e)

search_messages

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

پارامترها:

chat: شناسه (GUID)، لینک یا نام‌کاربری چت.
text: متن مورد جستجو.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        results = app.search_messages("https://rubika.ir/joing/JGDJDBDJ0SRHELBQEBMZQFTPTKWSHDLCD", text="سلام")
        print(results)

    except Exception as e:
        print(e)

search_chat_messages

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

پارامترها:

chat: شناسه (GUID)، لینک یا نام‌کاربری چت.
search_text: متن مورد جستجو. اگر با # شروع شود، جستجو بر اساس هشتگ انجام می‌شود.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        results = app.search_chat_messages("u0abc123...", search_text="#مهم")
        print(results)

    except Exception as e:
        print(e)

search_global_messages

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

پارامترها:

search_text: متن یا هشتگ مورد جستجو.
start_id: شناسه شروع برای صفحه‌بندی. (پیش‌فرض: None)

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        results = app.search_global_messages("#مهم")
        print(results)

    except Exception as e:
        print(e)

get_message_url

این متد برای دریافت لینک قابل اشتراک‌گذاری یک پیام است.

پارامترها:

chat: شناسه (GUID)، لینک یا نام‌کاربری چت.
message_id: شناسه پیام.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        url = app.get_message_url("@Online_User", message_id="12345674187")
        print(url)

    except Exception as e:
        print(e)

get_scheduled_messages

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

پارامترها:

chat: شناسه (GUID)، لینک یا نام‌کاربری چت.
start_id: شناسه شروع برای صفحه‌بندی. (پیش‌فرض: None)

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        scheduled = app.get_scheduled_messages("@CodeYaran")
        print(scheduled)

    except Exception as e:
        print(e)

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