sendMediaGroup
متداز این متد برای ارسال گروهی از عکس‌ها، عکس‌های زنده، ویدیوها، اسناد یا فایل‌های صوتی به‌صورت آلبوم استفاده کنید. اسناد و فایل‌های صوتی را فقط می‌توان با پیام‌های هم‌نوع خودشان در یک آلبوم گروه‌بندی کرد. در صورت موفقیت، آرایه‌ای از اشیای Message ارسال‌شده برگردانده می‌شود.
خروجی: Array of Message
پارامترها
| نام | نوع | الزام | توضیحات |
|---|---|---|---|
| business_connection_id | String | اختیاری | شناسهٔ یکتای اتصال کسب‌وکاری که پیام از طرف آن فرستاده می‌شود. |
| chat_id | Integer or String | الزامی | شناسهٔ یکتای گفتگوی هدف یا نام‌کاربری ربات، ابرگروه یا کانال هدف با قالب @username |
| message_thread_id | Integer | اختیاری | شناسهٔ یکتای رشتهٔ پیام (تاپیک) فروم هدف؛ فقط برای ابرگروه‌های فروم و گفتگوهای خصوصی ربات‌هایی که حالت تاپیک فروم برایشان فعال است. |
| direct_messages_topic_id | Integer | اختیاری | شناسهٔ تاپیک پیام مستقیم که پیام‌ها به آن فرستاده می‌شوند؛ اگر پیام‌ها به یک گفتگوی پیام مستقیم فرستاده شوند الزامی است. |
| media | Array of InputMediaAudio or Array of InputMediaDocument or Array of InputMediaLivePhoto or Array of InputMediaPhoto or Array of InputMediaVideo | الزامی | آرایهٔ سریالایز‌شده به JSON که پیام‌های ارسالی را توصیف می‌کند؛ باید ۲ تا ۱۰ مورد داشته باشد. |
| disable_notification | Boolean | اختیاری | پیام‌ها را بی‌صدا می‌فرستد. کاربران اعلانی بدون صدا دریافت می‌کنند. |
| protect_content | Boolean | اختیاری | محتوای پیام‌های ارسالی را از فوروارد و ذخیره‌شدن محافظت می‌کند. |
| allow_paid_broadcast | Boolean | اختیاری | برای مجاز شدن ارسال تا ۱۰۰۰ پیام در ثانیه و نادیده‌گرفتن محدودیت‌های ارسال انبوه، با هزینهٔ ۰٫۱ ستارهٔ تلگرام برای هر پیام، True بدهید. ستارهٔ مربوط از موجودی ربات کسر می‌شود. |
| message_effect_id | String | اختیاری | شناسهٔ یکتای افکتی که به پیام اضافه می‌شود؛ فقط برای گفتگوهای خصوصی |
| reply_parameters | ReplyParameters | اختیاری | توضیحات پیامی که به آن پاسخ داده می‌شود. |