telegram api method · layer 229 · #0330e77f
messages.sendMedia
Send a media
definition
messages.sendMedia#330e77f 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 schedule_repeat_period:flags.24?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 | true | Send message silently (no notification should be triggered) |
background | true | Send message in background |
clear_draft | true | Clear the draft |
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 | Destination |
reply_to | 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 |
random_id | long | Random ID to avoid resending the same message |
reply_markup | ReplyMarkup | Reply markup for bot keyboards |
entities | Vector<MessageEntity> | Message entities for styled text |
schedule_date | int | Scheduled message date for scheduled messages |
schedule_repeat_period | int | |
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. |
suggested_post | SuggestedPost | Used to suggest a post to a channel, see here » for more info on the full flow. |
returns
errors (122)
| code | error | description |
|---|---|---|
| 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_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 | 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. |
| 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 | CHAT_RESTRICTED | You can't send messages in this chat, you were restricted. |
| 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 | Message effects can only be used in private 1-on-1 chats, but the caller tried to send a message with an effect to a group or channel. |
| 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 | The specified extended media is empty. |
| 400 | EXTENDED_MEDIA_INVALID | The specified paid media is invalid. |
| 400 | EXTENDED_MEDIA_PEER_INVALID | Paid media is not allowed for the target peer. |
| 400 | EXTERNAL_URL_INVALID | External URL invalid. |
| 400 | FILE_PART_LENGTH_INVALID | The length of a file part is invalid. |
| 400 | FILE_PARTS_INVALID | The number of file parts 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_FILE_INVALID | The specified media file is invalid. |
| 400 | MEDIA_INVALID | Media invalid. |
| 400 | MESSAGE_EMPTY | The provided message is empty. |
| 400 | MESSAGE_TOO_LONG | The provided message is too long. |
| 400 | MSG_ID_INVALID | Invalid message ID provided. |
| 400 | PAYMENT_PROVIDER_INVALID | The specified payment provider is invalid. |
| 400 | 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_ANSWER_INVALID | One of the poll answers is not acceptable. |
| 400 | POLL_ANSWERS_INVALID | Invalid poll answers were provided. |
| 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. |
| 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_ANSWER_INVALID | An invalid value was provided to the correct_answers field. |
| 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_MULTIPLE_INVALID | Quizzes can't have the multiple_choice flag set! |
| 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_MESSAGE_ID_INVALID | The specified reply-to message ID is invalid. |
| 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_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_ITEM_DUPLICATE | Duplicate checklist items detected. |
| 400 | TODO_ITEMS_EMPTY | A checklist was specified, but no checklist items were passed. |
| 400 | TODO_ITEMS_TOO_MUCH | You specified too many todo list items. |
| 400 | TOPIC_CLOSED | This topic was closed, you can't send messages to it anymore. |
| 400 | 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. |
| 400 | USER_BOT_TO_BOT_DISABLED | Bot-to-bot messaging is disabled because one of the two bots hasn't enabled the Bot to Bot setting in @BotFather. |
| 400 | 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. |
| 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_ADMIN_REQUIRED | You must be an admin in this chat to do this. |
| 403 | CHAT_GUEST_SEND_FORBIDDEN | You join the discussion group before commenting, see here » for more info. |
| 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. |
| 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. |
| 403 | USER_IS_BLOCKED | You were blocked by this user. |
| 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. . |
| 406 | CHANNEL_PRIVATE | You haven't joined this channel/supergroup. |
| 406 | PEER_ID_INVALID | The provided peer id is invalid. |
| 406 | TOPIC_CLOSED | This topic was closed, you can't send messages to it anymore. |
| 406 | TOPIC_DELETED | The specified topic was deleted. |
| 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 2–229 · constructor id changed 11×
| id | layers |
|---|---|
| #a3c85d76 | 2–23 |
| #c8f16791 | 46–75 |
| #b8d1262b | 76–104 |
| #3491eba9 | 105–134 |
| #e25ff8e0 | 135–147 |
| #7547c966 | 148–159 |
| #72ccc23d | 160–175 |
| #7bd66041 | 176–179 |
| #7852834e | 180–199 |
| #a550cd78 | 200–205 |
| #ac55d9c1 | 206–216 |
| #0330e77f | 217–229 |