messages.SendMultiMedia

class pyrogram.raw.functions.messages.SendMultiMedia

Send an album or grouped media

Details:
  • Layer: 227

  • ID: 1BF89D74

Parameters:
  • peer (InputPeer) – The destination chat

  • multi_media (List of InputSingleMedia) – The medias to send: note that they must be separately uploaded using messages.uploadMedia first, using raw inputMediaUploaded* constructors is not supported.

  • silent (bool, optional) – Whether to send the album silently (no notification triggered)

  • background (bool, optional) – Send in background?

  • clear_draft (bool, optional) – Whether to clear drafts

  • noforwards (bool, optional) – Only for bots, disallows forwarding and saving of the messages, even if the destination chat doesn’t have content protection enabled

  • update_stickersets_order (bool, optional) – Whether to move used stickersets to top, see here for more info on this flag »

  • invert_media (bool, optional) – If set, any eventual webpage preview will be shown on top of the message instead of at the bottom.

  • allow_paid_floodskip (bool, optional) – Bots only: if set, allows sending up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot’s balance.

  • reply_to (InputReplyTo, optional) – If set, indicates that the message should be sent in reply to the specified message or story.

  • schedule_date (int 32-bit, optional) – Scheduled message date for scheduled messages

  • send_as (InputPeer, optional) – Send this message as the specified peer

  • quick_reply_shortcut (InputQuickReplyShortcut, optional) – Add the message to the specified quick reply shortcut », instead.

  • effect (int 64-bit, optional) – Specifies a message effect » to use for the message.

  • allow_paid_stars (int 64-bit, optional) – For paid messages », specifies the amount of Telegram Stars the user has agreed to pay in order to send the message.

Returns:

Updates

TL Schema

messages.sendMultiMedia#1bf89d74
flags:#
silent:flags.5?true
background:flags.6?true
clear_draft:flags.7?true
noforwards:flags.14?true
update_stickersets_order:flags.15?true
invert_media:flags.16?true
allow_paid_floodskip:flags.19?true
peer:InputPeer
reply_to:flags.0?InputReplyTo
multi_media:Vector<InputSingleMedia>
schedule_date:flags.10?int
send_as:flags.13?InputPeer
quick_reply_shortcut:flags.17?InputQuickReplyShortcut
effect:flags.18?long
allow_paid_stars:flags.21?long

= Updates

Parameter Tree

SendMultiMedia
├── silent → true (optional)
├── background → true (optional)
├── clear_draft → true (optional)
├── noforwards → true (optional)
├── update_stickersets_order → true (optional)
├── invert_media → true (optional)
├── allow_paid_floodskip → true (optional)
├── peer → InputPeer
│ ├── InputPeerEmpty
│ ├── InputPeerSelf
│ ├── InputPeerChat
│ │ └── chat_id → long
│ ├── InputPeerUser
│ │ ├── user_id → long
│ │ └── access_hash → long
│ ├── InputPeerChannel
│ │ ├── channel_id → long
│ │ └── access_hash → long
│ │ ├── peer → InputPeer
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ ├── msg_id → int
│ │ └── user_id → long
│ ├── peer → InputPeer
│ │ ├── InputPeerEmpty
│ │ ├── InputPeerSelf
│ │ ├── InputPeerChat
│ │ ├── InputPeerUser
│ │ ├── InputPeerChannel
│ │ ├── InputPeerUserFromMessage
│ │ └── InputPeerChannelFromMessage
│ ├── msg_id → int
│ └── channel_id → long
├── reply_to → InputReplyTo (optional)
│ ├── InputReplyToMessage
│ │ ├── reply_to_msg_id → int
│ │ ├── top_msg_id → int (optional)
│ │ ├── reply_to_peer_id → InputPeer (optional)
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ ├── quote_text → string (optional)
│ │ ├── quote_entities → Vector < MessageEntity > (optional)
│ │ │ ├── MessageEntityUnknown
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntityMention
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntityHashtag
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntityBotCommand
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntityUrl
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntityEmail
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntityBold
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntityItalic
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntityCode
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntityPre
│ │ │ │ ├── offset → int
│ │ │ │ ├── length → int
│ │ │ │ └── language → string
│ │ │ ├── MessageEntityTextUrl
│ │ │ │ ├── offset → int
│ │ │ │ ├── length → int
│ │ │ │ └── url → string
│ │ │ ├── MessageEntityMentionName
│ │ │ │ ├── offset → int
│ │ │ │ ├── length → int
│ │ │ │ └── user_id → long
│ │ │ ├── InputMessageEntityMentionName
│ │ │ │ ├── offset → int
│ │ │ │ ├── length → int
│ │ │ │ └── user_id → InputUser
│ │ │ │ ├── InputUserEmpty
│ │ │ │ ├── InputUserSelf
│ │ │ │ ├── InputUser
│ │ │ │ └── InputUserFromMessage
│ │ │ ├── MessageEntityPhone
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntityCashtag
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntityUnderline
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntityStrike
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntityBankCard
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntitySpoiler
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntityCustomEmoji
│ │ │ │ ├── offset → int
│ │ │ │ ├── length → int
│ │ │ │ └── document_id → long
│ │ │ ├── MessageEntityBlockquote
│ │ │ │ ├── collapsed → true (optional)
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntityFormattedDate
│ │ │ │ ├── relative → true (optional)
│ │ │ │ ├── short_time → true (optional)
│ │ │ │ ├── long_time → true (optional)
│ │ │ │ ├── short_date → true (optional)
│ │ │ │ ├── long_date → true (optional)
│ │ │ │ ├── day_of_week → true (optional)
│ │ │ │ ├── offset → int
│ │ │ │ ├── length → int
│ │ │ │ └── date → int
│ │ │ ├── MessageEntityDiffInsert
│ │ │ │ ├── offset → int
│ │ │ │ └── length → int
│ │ │ ├── MessageEntityDiffReplace
│ │ │ │ ├── offset → int
│ │ │ │ ├── length → int
│ │ │ │ └── old_text → string
│ │ │ └── MessageEntityDiffDelete
│ │ │ ├── offset → int
│ │ │ └── length → int
│ │ ├── quote_offset → int (optional)
│ │ ├── monoforum_peer_id → InputPeer (optional)
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ ├── todo_item_id → int (optional)
│ │ └── poll_option → bytes (optional)
│ ├── InputReplyToStory
│ │ ├── peer → InputPeer
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ └── story_id → int
│ └── InputReplyToMonoForum
│ └── monoforum_peer_id → InputPeer
│ ├── InputPeerEmpty
│ ├── InputPeerSelf
│ ├── InputPeerChat
│ ├── InputPeerUser
│ ├── InputPeerChannel
├── multi_media → Vector < InputSingleMedia >
│ └── InputSingleMedia
│ ├── media → InputMedia
│ │ ├── InputMediaEmpty
│ │ ├── InputMediaUploadedPhoto
│ │ ├── InputMediaPhoto
│ │ ├── InputMediaGeoPoint
│ │ ├── InputMediaContact
│ │ ├── InputMediaUploadedDocument
│ │ ├── InputMediaDocument
│ │ ├── InputMediaVenue
│ │ ├── InputMediaPhotoExternal
│ │ ├── InputMediaDocumentExternal
│ │ ├── InputMediaGame
│ │ ├── InputMediaInvoice
│ │ ├── InputMediaGeoLive
│ │ ├── InputMediaPoll
│ │ ├── InputMediaDice
│ │ ├── InputMediaStory
│ │ ├── InputMediaWebPage
│ │ ├── InputMediaPaidMedia
│ │ ├── InputMediaTodo
│ │ └── InputMediaStakeDice
│ ├── random_id → long
│ ├── message → string
│ └── entities → Vector < MessageEntity > (optional)
│ ├── MessageEntityUnknown
│ │ ├── offset → int
│ │ └── length → int
│ ├── MessageEntityMention
│ │ ├── offset → int
│ │ └── length → int
│ ├── MessageEntityHashtag
│ │ ├── offset → int
│ │ └── length → int
│ │ ├── offset → int
│ │ └── length → int
│ ├── MessageEntityUrl
│ │ ├── offset → int
│ │ └── length → int
│ ├── MessageEntityEmail
│ │ ├── offset → int
│ │ └── length → int
│ ├── MessageEntityBold
│ │ ├── offset → int
│ │ └── length → int
│ ├── MessageEntityItalic
│ │ ├── offset → int
│ │ └── length → int
│ ├── MessageEntityCode
│ │ ├── offset → int
│ │ └── length → int
│ ├── MessageEntityPre
│ │ ├── offset → int
│ │ ├── length → int
│ │ └── language → string
│ ├── MessageEntityTextUrl
│ │ ├── offset → int
│ │ ├── length → int
│ │ └── url → string
│ │ ├── offset → int
│ │ ├── length → int
│ │ └── user_id → long
│ │ ├── offset → int
│ │ ├── length → int
│ │ └── user_id → InputUser
│ │ ├── InputUserEmpty
│ │ ├── InputUserSelf
│ │ ├── InputUser
│ │ └── InputUserFromMessage
│ ├── MessageEntityPhone
│ │ ├── offset → int
│ │ └── length → int
│ ├── MessageEntityCashtag
│ │ ├── offset → int
│ │ └── length → int
│ │ ├── offset → int
│ │ └── length → int
│ ├── MessageEntityStrike
│ │ ├── offset → int
│ │ └── length → int
│ ├── MessageEntityBankCard
│ │ ├── offset → int
│ │ └── length → int
│ ├── MessageEntitySpoiler
│ │ ├── offset → int
│ │ └── length → int
│ │ ├── offset → int
│ │ ├── length → int
│ │ └── document_id → long
│ │ ├── collapsed → true (optional)
│ │ ├── offset → int
│ │ └── length → int
│ │ ├── relative → true (optional)
│ │ ├── short_time → true (optional)
│ │ ├── long_time → true (optional)
│ │ ├── short_date → true (optional)
│ │ ├── long_date → true (optional)
│ │ ├── day_of_week → true (optional)
│ │ ├── offset → int
│ │ ├── length → int
│ │ └── date → int
│ │ ├── offset → int
│ │ └── length → int
│ │ ├── offset → int
│ │ ├── length → int
│ │ └── old_text → string
│ ├── offset → int
│ └── length → int
├── schedule_date → int (optional)
├── send_as → InputPeer (optional)
│ ├── InputPeerEmpty
│ ├── InputPeerSelf
│ ├── InputPeerChat
│ │ └── chat_id → long
│ ├── InputPeerUser
│ │ ├── user_id → long
│ │ └── access_hash → long
│ ├── InputPeerChannel
│ │ ├── channel_id → long
│ │ └── access_hash → long
│ │ ├── peer → InputPeer
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ ├── msg_id → int
│ │ └── user_id → long
│ ├── peer → InputPeer
│ │ ├── InputPeerEmpty
│ │ ├── InputPeerSelf
│ │ ├── InputPeerChat
│ │ ├── InputPeerUser
│ │ ├── InputPeerChannel
│ │ ├── InputPeerUserFromMessage
│ │ └── InputPeerChannelFromMessage
│ ├── msg_id → int
│ └── channel_id → long
├── quick_reply_shortcut → InputQuickReplyShortcut (optional)
│ │ └── shortcut → string
│ └── shortcut_id → int
├── effect → long (optional)
└── allow_paid_stars → long (optional)

Example

await app.invoke(
    SendMultiMedia(
        silent=None,
        background=None,
        clear_draft=None,
        noforwards=None,
        update_stickersets_order=None,
        invert_media=None,
        allow_paid_floodskip=None,
        peer=await app.resolve_peer(chat_id),
        reply_to=InputReplyToMessage(
            reply_to_msg_id=0,
            top_msg_id=None,
            reply_to_peer_id=None,
            quote_text=None,
            quote_entities=None,
            quote_offset=None,
            monoforum_peer_id=None,
            todo_item_id=None,
            poll_option=None
        ),
        multi_media=[
                InputSingleMedia(
                    media=InputMediaEmpty(),
                    random_id=app.rnd_id(),
                    message="Hello",
                    entities=None
                )
            ],
        schedule_date=0,
        send_as=await app.resolve_peer(chat_id),
        quick_reply_shortcut=InputQuickReplyShortcut(shortcut="text"),
        effect=0,
        allow_paid_stars=0,
    )
)