Layer 220
MessagesSendMultiMedia
Send an album or grouped media
method
Users
Bots
Business
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 | flags.5?true | Whether to send the album silently (no notification triggered) |
| Background | flags.6?true | Send in background? |
| ClearDraft | flags.7?true | Whether to clear drafts |
| Noforwards | flags.14?true | Only for bots, disallows forwarding and saving of the messages, even if the destination chat doesn't have content protection enabled |
| UpdateStickersetsOrder | flags.15?true | Whether to move used stickersets to top, see here for more info on this flag |
| InvertMedia | flags.16?true | If set, any eventual webpage preview will be shown on top of the message instead of at the bottom. |
| AllowPaidFloodskip | flags.19?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 |
| ReplyTo | flags.0?InputReplyTo | If set, indicates that the message should be sent in reply to the specified message or story. |
| MultiMedia | Vector<InputSingleMedia> | The medias to send: note that they must be separately uploaded using messages. upload Media first, using raw input Media Uploaded* constructors is not supported. |
| ScheduleDate | flags.10?int | Scheduled message date for scheduled messages |
| SendAs | flags.13?InputPeer | Send this message as the specified peer |
| QuickReplyShortcut | flags.17?InputQuickReplyShortcut | Add the message to the specified quick reply shortcut, instead. |
| Effect | flags.18?long | Specifies a message effect to use for the message. |
| AllowPaidStars | flags.21?long | For paid messages, specifies the amount of Telegram Stars the user has agreed to pay in order to send the message. |
Returns
UpdatesPossible Errors
| Code | Type | Description |
|---|---|---|
| 403 | ALLOW_PAYMENT_REQUIRED_%d | This peer charges <number> Telegram Stars per message, but the allow_paid_stars was not set or its value is smaller than <number>. |
| 400 | BUSINESS_CONNECTION_INVALID | The connection_id passed to the wrapping invoke With Business Connection call is invalid. |
| 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. |
| 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. |
| 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_EXPIRED | The file reference of the media file at index <number> 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 <number> 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 app Config. quick_replies_limit shortcuts may be created, the limit was reached. |
| 500 | RANDOM_ID_DUPLICATE | You provided a random ID that was already used. |
| 400 | RANDOM_ID_EMPTY | Random ID empty. |
| 400 | REPLY_MESSAGES_TOO_MUCH | Each shortcut can contain a maximum of app Config. 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. |
| 420 | SLOWMODE_WAIT_%d | Slowmode is enabled in this chat: wait <number> seconds before sending another message to this chat. |
| 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. |
Gogram Example
// MessagesSendMultiMedia - using Params struct result, err := client.MessagesSendMultiMedia(&tg.MessagesSendMultiMediaParams{ Peer: &tg.InputPeerUser{UserID: int64(123456789)}, MultiMedia: []tg.InputSingleMedia{&tg.InputSingleMedia{}}, // Optional fields: // Silent: true, // Background: true, // ClearDraft: true, // Noforwards: true, // ... }) if err != nil { // handle error } // result is *tg.Updates