messages.sendMedia - Gogram TL Reference

Layer 220

method Users Bots Business

messages.sendMedia#ac55d9c1 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 media:InputMedia message:string random_id:long reply_markup:flags.2?ReplyMarkup entities:flags.3?Vector<MessageEntity> 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 suggested_post:flags.22?SuggestedPost = Updates;

Parameters

Name	Type	Description
Flags	#	Flags, see TL conditional fields
Silent	flags.5?true	Send message silently (no notification should be triggered)
Background	flags.6?true	Send message in background
ClearDraft	flags.7?true	Clear the draft
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	Destination
ReplyTo	flags.0?InputReplyTo	If set, indicates that the message should be sent in reply to the specified message or story.
Media	InputMedia	Attached media
Message	string	Caption
RandomId	long	Random ID to avoid resending the same message
ReplyMarkup	flags.2?ReplyMarkup	Reply markup for bot keyboards
Entities	Vector<MessageEntity>	Message entities for styled text
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.
SuggestedPost	flags.22?SuggestedPost	Used to suggest a post to a channel, see here for more info on the full flow.

Returns

Updates

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..
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	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 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	BUTTON_COPY_TEXT_INVALID	The specified keyboard Button Copy. 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 input Keyboard Button User Profile 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_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 input Media Paid Media is invalid.
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 Input File 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 MD 5 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 app Config. 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 keyboard Button Game 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 app Config. quick_reply_messages_limit messages, the limit was reached.
400	REPLY_MESSAGE_ID_INVALID	The specified reply-to message 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.
420	SLOWMODE_WAIT_%d	Slowmode is enabled in this chat: wait <number> seconds before sending another message to this chat.
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. export Invoice.
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 c URL.
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.

Gogram Example

// MessagesSendMedia - using Params struct
result, err := client.MessagesSendMedia(&tg.MessagesSendMediaParams{
    Peer: &tg.InputPeerUser{UserID: int64(123456789)},
    Media: &tg.InputMediaPhoto{ID: &tg.InputPhoto{ID: int64(0), AccessHash: int64(0), FileReference: []byte{}}},
    Message: "...",
    RandomId: int64(0),

    // Optional fields:
    // Silent: true,
    // Background: true,
    // ClearDraft: true,
    // Noforwards: true,
    // ...
})
if err != nil {
    // handle error
}
// result is *tg.Updates