Skip to content

ابزارهای پیام

transcribe_voice

این متد برای تبدیل صوت به متن (پیاده‌سازی متن پیام صوتی) به کار می‌رود.

پارامترها:

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

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

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    text = app.transcribe_voice("u0abc123...", message_id="123456")
    print(text)

get_poll_status

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

پارامتر:

  • poll_id: شناسه نظرسنجی.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    status = app.get_poll_status("poll_123")
    print(status)

get_poll_option_voters

این متد برای دریافت رأی‌دهندگان یک گزینه خاص از نظرسنجی به کار می‌رود.

پارامترها:

  • poll_id: شناسه نظرسنجی.
  • selection_index: ایندکس گزینه مورد نظر.
  • start_id: شناسه شروع برای صفحه‌بندی. (پیش‌فرض: None)

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    voters = app.get_poll_option_voters("poll_123", selection_index=0)
    print(voters)

vote_poll

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

پارامترها:

  • poll_id: شناسه نظرسنجی.
  • selection_index: ایندکس گزینه مورد نظر.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    result = app.vote_poll("poll_123", selection_index=0)
    print(result)

stop_poll

این متد برای متوقف کردن یک نظرسنجی به کار می‌رود.

پارامتر:

  • poll_id: شناسه نظرسنجی.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    result = app.stop_poll("poll_123")
    print(result)

retract_poll

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

پارامتر:

  • poll_id: شناسه نظرسنجی.

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    result = app.retract_poll("poll_123")
    print(result)

request_send_file

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

پارامترها:

  • file_name: نام فایل.
  • size: اندازه فایل (به بایت).
  • mime: نوع MIME فایل. (پیش‌فرض: None - تشخیص از روی پسوند فایل)

مثال:

Python
from maxrubika import Messenger

with Messenger("mySession") as app:
    result = app.request_send_file(
        file_name="document.pdf",
        size=1024000
    )
    print(result)