`messages.sendMedia`

Send a media

func (c *Client) MessagesSendMedia(ctx context.Context, request *MessagesSendMediaRequest) (UpdatesClass, error)

Calling this method

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

Parameters

Name	Type	Required	Description
`Silent`	`bool`	—	Send message silently (no notification should be triggered)
`Background`	`bool`	—	Send message in background
`ClearDraft`	`bool`	—	Clear the draft
`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	Destination
`ReplyTo`	`InputReplyToClass`	—	If set, indicates that the message should be sent in reply to the specified message or story.
`Media`	`InputMediaClass`	yes	Attached media
`Message`	`string`	yes	Caption
`RandomID`	`int64`	yes	Random ID to avoid resending the same message
`ReplyMarkup`	`ReplyMarkupClass`	—	Reply markup for bot keyboards
`Entities`	`[]MessageEntityClass`	—	Message entities for styled text
`ScheduleDate`	`int`	—	Scheduled message date for scheduled messages
`ScheduleRepeatPeriod`	`int`	—	Once sent, this message will be automatically re-scheduled to be re-sent again this many seconds in the future, see here » for more info on repeating 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.
`SuggestedPost`	`SuggestedPost`	—	Used to suggest a post to a channel, see here » for more info on the full flow.

Returns

UpdatesClass

Possible errors

Code	Type	Description
406	`ALLOW_PAYMENT_REQUIRED`	This peer only accepts paid messages »: this error is only emitted for older layers without paid messages support, so the client must be updated in order to use paid messages. .
400	`BOT_GAMES_DISABLED`	Games can't be sent to channels.
400	`BOT_PAYMENTS_DISABLED`	Please enable bot payments in botfather before calling this method.
400	`BROADCAST_PUBLIC_VOTERS_FORBIDDEN`	You can't forward polls with public voters.
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	`BUSINESS_PEER_USAGE_MISSING`	You cannot send a message to a user through a business connection if the user hasn't recently contacted us.
400	`BUTTON_COPY_TEXT_INVALID`	The specified keyboardButtonCopy.copy_text is invalid.
400	`BUTTON_DATA_INVALID`	The data of one or more of the buttons you provided is invalid.
400	`BUTTON_POS_INVALID`	The position of one of the keyboard buttons is invalid (i.e. a Game or Pay button not in the first position, and so on...).
400	`BUTTON_TYPE_INVALID`	The type of one or more of the buttons you provided is invalid.
400	`BUTTON_URL_INVALID`	Button URL invalid.
400	`BUTTON_USER_PRIVACY_RESTRICTED`	The privacy setting of the user specified in a inputKeyboardButtonUserProfile button do not allow creating such a button.
400	`CHANNEL_INVALID`	The provided channel is invalid.
406	`CHANNEL_PRIVATE`	You haven't joined this channel/supergroup.
403	`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_GUEST_SEND_FORBIDDEN`	You join the discussion group before commenting, see here » for more info.
400	`CHAT_RESTRICTED`	You can't send messages in this chat, you were restricted.
403	`CHAT_SEND_AUDIOS_FORBIDDEN`	You can't send audio messages in this chat.
403	`CHAT_SEND_DOCS_FORBIDDEN`	You can't send documents in this chat.
403	`CHAT_SEND_GIFS_FORBIDDEN`	You can't send gifs in this 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_PLAIN_FORBIDDEN`	You can't send non-media (text) messages in this chat.
403	`CHAT_SEND_POLL_FORBIDDEN`	You can't send polls in this chat.
403	`CHAT_SEND_ROUNDVIDEOS_FORBIDDEN`	You can't send round videos to this chat.
403	`CHAT_SEND_STICKERS_FORBIDDEN`	You can't send stickers in this chat.
403	`CHAT_SEND_VIDEOS_FORBIDDEN`	You can't send videos in this chat.
403	`CHAT_SEND_VOICES_FORBIDDEN`	You can't send voice recordings in this chat.
403	`CHAT_WRITE_FORBIDDEN`	You can't write in this chat.
400	`CURRENCY_TOTAL_AMOUNT_INVALID`	The total amount of all prices is invalid.
400	`DOCUMENT_INVALID`	The specified document is invalid.
400	`EFFECT_CHAT_INVALID`
400	`EFFECT_ID_INVALID`	The specified effect ID is invalid.
400	`EMOTICON_INVALID`	The specified emoji 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	`EXTENDED_MEDIA_AMOUNT_INVALID`	The specified stars_amount of the passed inputMediaPaidMedia is invalid.
400	`EXTENDED_MEDIA_EMPTY`
400	`EXTENDED_MEDIA_INVALID`	The specified paid media is invalid.
400	`EXTERNAL_URL_INVALID`	External URL invalid.
400	`FILE_PARTS_INVALID`	The number of file parts is invalid.
400	`FILE_PART_LENGTH_INVALID`	The length of a file part is invalid.
400	`FILE_REFERENCE_EMPTY`	An empty file reference was specified.
400	`FILE_REFERENCE_EXPIRED`	File reference expired, it must be refetched as described in the documentation.
400	`GAME_BOT_INVALID`	Bots can't send another bot's game.
400	`IMAGE_PROCESS_FAILED`	Failure while processing image.
400	`INPUT_FILE_INVALID`	The specified InputFile is invalid.
400	`INPUT_USER_DEACTIVATED`	The specified user was deleted.
400	`INVOICE_PAYLOAD_INVALID`	The specified invoice payload is invalid.
400	`MD5_CHECKSUM_INVALID`	The MD5 checksums do not match.
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	`MESSAGE_EMPTY`	The provided message is empty.
400	`MSG_ID_INVALID`	Invalid message ID provided.
400	`PAYMENT_PROVIDER_INVALID`	The specified payment provider is invalid.
406	`PEER_ID_INVALID`	The provided peer id is invalid.
400	`PHOTO_EXT_INVALID`	The extension of the photo is invalid.
400	`PHOTO_INVALID_DIMENSIONS`	The photo dimensions are invalid.
400	`PHOTO_SAVE_FILE_INVALID`	Internal issues, try again later.
400	`POLL_ANSWERS_INVALID`	Invalid poll answers were provided.
400	`POLL_ANSWER_INVALID`	One of the poll answers is not acceptable.
400	`POLL_OPTION_DUPLICATE`	Duplicate poll options provided.
400	`POLL_OPTION_INVALID`	Invalid poll option provided.
400	`POLL_QUESTION_INVALID`	One of the poll questions is not acceptable.
403	`PREMIUM_ACCOUNT_REQUIRED`	A premium account is required to execute this action.
403	`PRIVACY_PREMIUM_REQUIRED`	You need a Telegram Premium subscription to send a message to this user.
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	`QUIZ_CORRECT_ANSWERS_EMPTY`	No correct quiz answer was specified.
400	`QUIZ_CORRECT_ANSWERS_TOO_MUCH`	You specified too many correct answers in a quiz, quizzes can only have one right answer!
400	`QUIZ_CORRECT_ANSWER_INVALID`	An invalid value was provided to the correct_answers field.
400	`QUIZ_MULTIPLE_INVALID`	Quizzes can't have the multiple_choice flag set!
500	`RANDOM_ID_DUPLICATE`	You provided a random ID that was already used.
400	`REPLY_MARKUP_BUY_EMPTY`	Reply markup for buy button empty.
400	`REPLY_MARKUP_GAME_EMPTY`	A game message is being edited, but the newly provided keyboard doesn't have a keyboardButtonGame button.
400	`REPLY_MARKUP_INVALID`	The provided reply markup is invalid.
400	`REPLY_MARKUP_TOO_LONG`	The specified reply_markup is too long.
400	`REPLY_MESSAGES_TOO_MUCH`	Each shortcut can contain a maximum of appConfig.quick_reply_messages_limit messages, the limit was reached.
400	`REPLY_MESSAGE_ID_INVALID`	The specified reply-to message ID is invalid.
400	`REPLY_TO_MONOFORUM_PEER_INVALID`	The specified inputReplyToMonoForum.monoforum_peer_id is invalid.
400	`SCHEDULE_BOT_NOT_ALLOWED`	Bots cannot schedule messages.
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	`STARS_INVOICE_INVALID`	The specified Telegram Star invoice is invalid.
400	`STORY_ID_INVALID`	The specified story ID is invalid.
400	`SUBSCRIPTION_EXPORT_MISSING`	You cannot send a bot subscription invoice directly, you may only create invoice links using payments.exportInvoice.
400	`SUGGESTED_POST_PEER_INVALID`	You cannot send suggested posts to non-monoforum peers.
400	`TERMS_URL_INVALID`	The specified invoice.terms_url is invalid.
400	`TODO_ITEMS_EMPTY`	A checklist was specified, but no checklist items were passed.
400	`TODO_ITEM_DUPLICATE`	Duplicate checklist items detected.
406	`TOPIC_CLOSED`	This topic was closed, you can't send messages to it anymore.
406	`TOPIC_DELETED`	The specified topic was deleted.
400	`TTL_MEDIA_INVALID`	Invalid media Time To Live was provided.
400	`USER_BANNED_IN_CHANNEL`	You're banned from sending messages in supergroups/channels.
403	`USER_IS_BLOCKED`	You were blocked by this user.
400	`USER_IS_BOT`	Bots can't send messages to other bots.
400	`VIDEO_CONTENT_TYPE_INVALID`	The video's content type is invalid.
400	`VOICE_MESSAGES_FORBIDDEN`	This user's privacy settings forbid you from sending voice messages.
400	`WEBDOCUMENT_MIME_INVALID`	Invalid webdocument mime type provided.
400	`WEBPAGE_CURL_FAILED`	Failure while fetching the webpage with cURL.
400	`WEBPAGE_MEDIA_EMPTY`	Webpage media empty.
400	`WEBPAGE_NOT_FOUND`	A preview for the specified webpage url could not be generated.
400	`WEBPAGE_URL_INVALID`	The specified webpage url is invalid.
400	`YOU_BLOCKED_USER`	You blocked this user.

References

Official documentation
Generated Go reference
TL definition: messages.sendMedia#330e77f

Calling this method​

Parameters​

Returns​

Possible errors​

References​

Calling this method

Parameters

Returns

Possible errors

References