telegram api method · layer 229 · #1bf89d74
messages.sendMultiMedia
Send an album or grouped media
definition
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;
parameters
| name | type | description |
|---|---|---|
flags | # | Flags, see TL conditional fields |
silent | true | Whether to send the album silently (no notification triggered) |
background | true | Send in background? |
clear_draft | true | Whether to clear drafts |
noforwards | true | Only for bots, disallows forwarding and saving of the messages, even if the destination chat doesn't have content protection enabled |
update_stickersets_order | true | Whether to move used stickersets to top, see here for more info on this flag » |
invert_media | true | If set, any eventual webpage preview will be shown on top of the message instead of at the bottom. |
allow_paid_floodskip | true | 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. |
peer | InputPeer | The destination chat |
reply_to | InputReplyTo | If set, indicates that the message should be sent in reply to the specified message or story. |
multi_media | Vector<InputSingleMedia> | The medias to send: note that they must be separately uploaded using messages.uploadMedia first, using raw inputMediaUploaded* constructors is not supported. |
schedule_date | int | Scheduled message date for scheduled messages |
send_as | InputPeer | Send this message as the specified peer |
quick_reply_shortcut | InputQuickReplyShortcut | Add the message to the specified quick reply shortcut », instead. |
effect | long | Specifies a message effect » to use for the message. |
allow_paid_stars | long | For paid messages », specifies the amount of Telegram Stars the user has agreed to pay in order to send the message. |
returns
errors (40)
| code | error | description |
|---|---|---|
| 400 | BUSINESS_CONNECTION_INVALID | The connection_id passed to the wrapping invokeWithBusinessConnection call is invalid. |
| 400 | BUSINESS_CONNECTION_NOT_ALLOWED | This method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we're a user, and users cannot invoke methods over a business connection; (2) we're a bot, but business mode was disabled in @botfather or (3); we're a bot, but this method cannot be invoked over a business connection. |
| 400 | BUSINESS_PEER_INVALID | Messages can't be set to the specified peer through the current business connection. |
| 400 | CHANNEL_INVALID | The provided channel is invalid. |
| 400 | CHANNEL_PRIVATE | You haven't joined this channel/supergroup. |
| 400 | CHAT_ADMIN_REQUIRED | You must be an admin in this chat to do this. |
| 400 | CHAT_FORWARDS_RESTRICTED | You can't forward messages from a protected chat. |
| 400 | EFFECT_ID_INVALID | The specified effect ID is invalid. |
| 400 | ENTITY_BOUNDS_INVALID | A specified entity offset or length is invalid, see here » for info on how to properly compute the entity offset/length. |
| 400 | FILE_REFERENCE_%d_EMPTY | The file reference of the media file at offset %d in the multi_media array is invalid. |
| 400 | FILE_REFERENCE_%d_EXPIRED | The file reference of the media file at index %d in the passed media array expired, it must be refreshed as specified in the documentation. . |
| 400 | FILE_REFERENCE_%d_INVALID | The file reference of the media file at index %d in the passed media array is invalid. |
| 400 | MEDIA_CAPTION_TOO_LONG | The caption is too long. |
| 400 | MEDIA_EMPTY | The provided media object is invalid. |
| 400 | MEDIA_INVALID | Media invalid. |
| 400 | MSG_ID_INVALID | Invalid message ID provided. |
| 400 | MULTI_MEDIA_TOO_LONG | Too many media files for album. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. |
| 400 | QUICK_REPLIES_BOT_NOT_ALLOWED | Quick replies cannot be used by bots. |
| 400 | QUICK_REPLIES_TOO_MUCH | A maximum of appConfig.`quick_replies_limit` shortcuts may be created, the limit was reached. |
| 400 | RANDOM_ID_EMPTY | Random ID empty. |
| 400 | REPLY_MESSAGES_TOO_MUCH | Each shortcut can contain a maximum of appConfig.`quick_reply_messages_limit` messages, the limit was reached. |
| 400 | REPLY_TO_INVALID | The specified reply_to field is invalid. |
| 400 | SCHEDULE_DATE_TOO_LATE | You can't schedule a message this far in the future. |
| 400 | SCHEDULE_TOO_MUCH | There are too many scheduled messages. |
| 400 | SEND_AS_PEER_INVALID | You can't send messages as the specified peer. |
| 400 | TOPIC_CLOSED | This topic was closed, you can't send messages to it anymore. |
| 400 | TOPIC_DELETED | The specified topic was deleted. |
| 400 | USER_BANNED_IN_CHANNEL | You're banned from sending messages in supergroups/channels. |
| 400 | USER_IS_BLOCKED | You were blocked by this user. |
| 401 | AUTH_KEY_UNREGISTERED | The specified authorization key is not registered in the system (for example, a PFS temporary key has expired). |
| 403 | ALLOW_PAYMENT_REQUIRED_%d | This peer charges %d Telegram Stars per message, but the allow_paid_stars was not set or its value is smaller than %d. |
| 403 | CHAT_SEND_MEDIA_FORBIDDEN | You can't send media in this chat. |
| 403 | CHAT_SEND_PHOTOS_FORBIDDEN | You can't send photos in this chat. |
| 403 | CHAT_SEND_VIDEOS_FORBIDDEN | You can't send videos in this chat. |
| 403 | CHAT_WRITE_FORBIDDEN | You can't write in this chat. |
| 403 | PRIVACY_PREMIUM_REQUIRED | You need a Telegram Premium subscription to send a message to this user. |
| 406 | PEER_ID_INVALID | The provided peer id is invalid. |
| 420 | SLOWMODE_WAIT_%d | Slowmode is enabled in this chat: wait %d seconds before sending another message to this chat. |
| 500 | RANDOM_ID_DUPLICATE | You provided a random ID that was already used. |
history
present in layers 73–229 · constructor id changed 7×
| id | layers |
|---|---|
| #2095512f | 73–104 |
| #cc0110cb | 105–134 |
| #f803138f | 135–147 |
| #b6f11a1c | 148–159 |
| #456e8987 | 160–175 |
| #0c964709 | 176–179 |
| #37b74355 | 180–199 |
| #1bf89d74 | 200–229 |