messages.SendMultiMedia

class pyrogram.raw.functions.messages.SendMultiMedia

Send an album or grouped media

Details:
  • Layer: 223

  • 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
├── silenttrue (optional)
├── backgroundtrue (optional)
├── clear_drafttrue (optional)
├── noforwardstrue (optional)
├── update_stickersets_ordertrue (optional)
├── invert_mediatrue (optional)
├── allow_paid_floodskiptrue (optional)
├── peerInputPeer
│ ├── InputPeerEmpty
│ ├── InputPeerSelf
│ ├── InputPeerChat
│ │ └── chat_idlong
│ ├── InputPeerUser
│ │ ├── user_idlong
│ │ └── access_hashlong
│ ├── InputPeerChannel
│ │ ├── channel_idlong
│ │ └── access_hashlong
│ │ ├── peerInputPeer
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ ├── msg_idint
│ │ └── user_idlong
│ ├── peerInputPeer
│ │ ├── InputPeerEmpty
│ │ ├── InputPeerSelf
│ │ ├── InputPeerChat
│ │ ├── InputPeerUser
│ │ ├── InputPeerChannel
│ │ ├── InputPeerUserFromMessage
│ │ └── InputPeerChannelFromMessage
│ ├── msg_idint
│ └── channel_idlong
├── reply_toInputReplyTo (optional)
│ ├── InputReplyToMessage
│ │ ├── reply_to_msg_idint
│ │ ├── top_msg_idint (optional)
│ │ ├── reply_to_peer_idInputPeer (optional)
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ ├── quote_textstring (optional)
│ │ ├── quote_entitiesVector < MessageEntity > (optional)
│ │ │ ├── MessageEntityUnknown
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityMention
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityHashtag
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityBotCommand
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityUrl
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityEmail
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityBold
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityItalic
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityCode
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityPre
│ │ │ │ ├── offsetint
│ │ │ │ ├── lengthint
│ │ │ │ └── languagestring
│ │ │ ├── MessageEntityTextUrl
│ │ │ │ ├── offsetint
│ │ │ │ ├── lengthint
│ │ │ │ └── urlstring
│ │ │ ├── MessageEntityMentionName
│ │ │ │ ├── offsetint
│ │ │ │ ├── lengthint
│ │ │ │ └── user_idlong
│ │ │ ├── InputMessageEntityMentionName
│ │ │ │ ├── offsetint
│ │ │ │ ├── lengthint
│ │ │ │ └── user_idInputUser
│ │ │ │ ├── InputUserEmpty
│ │ │ │ ├── InputUserSelf
│ │ │ │ ├── InputUser
│ │ │ │ └── InputUserFromMessage
│ │ │ ├── MessageEntityPhone
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityCashtag
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityUnderline
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityStrike
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityBankCard
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntitySpoiler
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityCustomEmoji
│ │ │ │ ├── offsetint
│ │ │ │ ├── lengthint
│ │ │ │ └── document_idlong
│ │ │ ├── MessageEntityBlockquote
│ │ │ │ ├── collapsedtrue (optional)
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ └── MessageEntityFormattedDate
│ │ │ ├── relativetrue (optional)
│ │ │ ├── short_timetrue (optional)
│ │ │ ├── long_timetrue (optional)
│ │ │ ├── short_datetrue (optional)
│ │ │ ├── long_datetrue (optional)
│ │ │ ├── day_of_weektrue (optional)
│ │ │ ├── offsetint
│ │ │ ├── lengthint
│ │ │ └── dateint
│ │ ├── quote_offsetint (optional)
│ │ ├── monoforum_peer_idInputPeer (optional)
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ └── todo_item_idint (optional)
│ ├── InputReplyToStory
│ │ ├── peerInputPeer
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ └── story_idint
│ └── InputReplyToMonoForum
│ └── monoforum_peer_idInputPeer
│ ├── InputPeerEmpty
│ ├── InputPeerSelf
│ ├── InputPeerChat
│ ├── InputPeerUser
│ ├── InputPeerChannel
├── multi_mediaVector < InputSingleMedia >
│ └── InputSingleMedia
│ ├── mediaInputMedia
│ │ ├── InputMediaEmpty
│ │ ├── InputMediaUploadedPhoto
│ │ ├── InputMediaPhoto
│ │ ├── InputMediaGeoPoint
│ │ ├── InputMediaContact
│ │ ├── InputMediaUploadedDocument
│ │ ├── InputMediaDocument
│ │ ├── InputMediaVenue
│ │ ├── InputMediaPhotoExternal
│ │ ├── InputMediaDocumentExternal
│ │ ├── InputMediaGame
│ │ ├── InputMediaInvoice
│ │ ├── InputMediaGeoLive
│ │ ├── InputMediaPoll
│ │ ├── InputMediaDice
│ │ ├── InputMediaStory
│ │ ├── InputMediaWebPage
│ │ ├── InputMediaPaidMedia
│ │ ├── InputMediaTodo
│ │ └── InputMediaStakeDice
│ ├── random_idlong
│ ├── messagestring
│ └── entitiesVector < MessageEntity > (optional)
│ ├── MessageEntityUnknown
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntityMention
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntityHashtag
│ │ ├── offsetint
│ │ └── lengthint
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntityUrl
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntityEmail
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntityBold
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntityItalic
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntityCode
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntityPre
│ │ ├── offsetint
│ │ ├── lengthint
│ │ └── languagestring
│ ├── MessageEntityTextUrl
│ │ ├── offsetint
│ │ ├── lengthint
│ │ └── urlstring
│ │ ├── offsetint
│ │ ├── lengthint
│ │ └── user_idlong
│ │ ├── offsetint
│ │ ├── lengthint
│ │ └── user_idInputUser
│ │ ├── InputUserEmpty
│ │ ├── InputUserSelf
│ │ ├── InputUser
│ │ └── InputUserFromMessage
│ ├── MessageEntityPhone
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntityCashtag
│ │ ├── offsetint
│ │ └── lengthint
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntityStrike
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntityBankCard
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntitySpoiler
│ │ ├── offsetint
│ │ └── lengthint
│ │ ├── offsetint
│ │ ├── lengthint
│ │ └── document_idlong
│ │ ├── collapsedtrue (optional)
│ │ ├── offsetint
│ │ └── lengthint
│ ├── relativetrue (optional)
│ ├── short_timetrue (optional)
│ ├── long_timetrue (optional)
│ ├── short_datetrue (optional)
│ ├── long_datetrue (optional)
│ ├── day_of_weektrue (optional)
│ ├── offsetint
│ ├── lengthint
│ └── dateint
├── schedule_dateint (optional)
├── send_asInputPeer (optional)
│ ├── InputPeerEmpty
│ ├── InputPeerSelf
│ ├── InputPeerChat
│ │ └── chat_idlong
│ ├── InputPeerUser
│ │ ├── user_idlong
│ │ └── access_hashlong
│ ├── InputPeerChannel
│ │ ├── channel_idlong
│ │ └── access_hashlong
│ │ ├── peerInputPeer
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ ├── msg_idint
│ │ └── user_idlong
│ ├── peerInputPeer
│ │ ├── InputPeerEmpty
│ │ ├── InputPeerSelf
│ │ ├── InputPeerChat
│ │ ├── InputPeerUser
│ │ ├── InputPeerChannel
│ │ ├── InputPeerUserFromMessage
│ │ └── InputPeerChannelFromMessage
│ ├── msg_idint
│ └── channel_idlong
├── quick_reply_shortcutInputQuickReplyShortcut (optional)
│ │ └── shortcutstring
│ └── shortcut_idint
├── effectlong (optional)
└── allow_paid_starslong (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
        ),
        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,
    )
)