messages.sendMultiMedia

Send an album or grouped media

func (c *Client) MessagesSendMultiMedia(ctx context.Context, request *MessagesSendMultiMediaRequest) (UpdatesClass, error)

Calling this method

client.Run(ctx, func(ctx context.Context) error {
	api := client.API()
	
	res, err := api.MessagesSendMultiMedia(ctx, &tg.MessagesSendMultiMediaRequest{
		// see Parameters
	})
	if err != nil {
		return err
	}
	_ = res // UpdatesClass
	return nil
})

Parameters

Name	Type	Required	Description
Silent	bool	—	Whether to send the album silently (no notification triggered)
Background	bool	—	Send in background?
ClearDraft	bool	—	Whether to clear drafts
Noforwards	bool	—	Only for bots, disallows forwarding and saving of the messages, even if the destination chat doesn't have content protection enabled
UpdateStickersetsOrder	bool	—	Whether to move used stickersets to top, see here for more info on this flag »
InvertMedia	bool	—	If set, any eventual webpage preview will be shown on top of the message instead of at the bottom.
AllowPaidFloodskip	bool	—	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	InputPeerClass	yes	The destination chat
ReplyTo	InputReplyToClass	—	If set, indicates that the message should be sent in reply to the specified message or story.
MultiMedia	[]InputSingleMedia	yes	The medias to send: note that they must be separately uploaded using messages uploadMedia first, using raw inputMediaUploaded* constructors is not supported.
ScheduleDate	int	—	Scheduled message date for scheduled messages
SendAs	InputPeerClass	—	Send this message as the specified peer
QuickReplyShortcut	InputQuickReplyShortcutClass	—	Add the message to the specified quick reply shortcut », instead.
Effect	int64	—	Specifies a message effect » to use for the message.
AllowPaidStars	int64	—	For paid messages », specifies the amount of Telegram Stars the user has agreed to pay in order to send the message.

Returns

UpdatesClass

Possible errors

Code	Type	Description
400	BUSINESS_CONNECTION_INVALID	The connection_id passed to the wrapping invokeWithBusinessConnection 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	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.
406	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.
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 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.

References

• Official documentation
• Generated Go reference
• TL definition: messages.sendMultiMedia#1bf89d74