SendMediaRequest

Both users and bots can use this request. See code examples.

---functions---
messages.sendMedia#7bd66041 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 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?date send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut = Updates

Returns

Updates

This type can be an instance of either:

UpdateShort	UpdateShortChatMessage
UpdateShortMessage	UpdateShortSentMessage
Updates	UpdatesCombined
UpdatesTooLong

Parameters

peer	InputPeer	Anything entity-like will work if the library can find its `Input` version (e.g., usernames, `Peer`, `User` or `Channel` objects, etc.).
media	InputMedia
message	string
silent	flag	This argument defaults to `None` and can be omitted.
background	flag	This argument defaults to `None` and can be omitted.
clear_draft	flag	This argument defaults to `None` and can be omitted.
noforwards	flag	This argument defaults to `None` and can be omitted.
update_stickersets_order	flag	This argument defaults to `None` and can be omitted.
invert_media	flag	This argument defaults to `None` and can be omitted.
reply_to	InputReplyTo	This argument defaults to `None` and can be omitted.
random_id	long	If left unspecified, it will be inferred automatically.
reply_markup	ReplyMarkup	This argument defaults to `None` and can be omitted.
entities	MessageEntity	This argument defaults to `None` and can be omitted. Otherwise, a list must be supplied.
schedule_date	date	This argument defaults to `None` and can be omitted.
send_as	InputPeer	This argument defaults to `None` and can be omitted. Anything entity-like will work if the library can find its `Input` version (e.g., usernames, `Peer`, `User` or `Channel` objects, etc.).
quick_reply_shortcut	InputQuickReplyShortcut	This argument defaults to `None` and can be omitted.

Known RPC errors

This request can cause 45 known errors:

`BotPaymentsDisabledError`	This method can only be run by a bot.
`BotPollsDisabledError`	You cannot create polls under a bot account.
`BroadcastPublicVotersForbiddenError`	You cannot broadcast polls where the voters are public.
`ChannelInvalidError`	Invalid channel object. Make sure to pass the right types, for instance making sure that the request is designed for channels or otherwise look for a different one more suited.
`ChannelPrivateError`	The channel specified is private and you lack permission to access it. Another reason may be that you were banned from it.
`ChatAdminRequiredError`	Chat admin privileges are required to do that in the specified chat (for example, to send a message in a channel which is not yours), or invalid permissions used for the channel or group.
`ChatSendMediaForbiddenError`	You can't send media in this chat.
`ChatWriteForbiddenError`	You can't write in this chat.
`CurrencyTotalAmountInvalidError`	The total amount of all prices is invalid.
`EmoticonInvalidError`	The specified emoticon cannot be used or was not a emoticon.
`EntityBoundsInvalidError`	Some of provided entities have invalid bounds (length is zero or out of the boundaries of the string).
`ExternalUrlInvalidError`	External URL invalid.
`FilePartsInvalidError`	The number of file parts is invalid.
`FilePartLengthInvalidError`	The length of a file part is invalid.
`FileReferenceEmptyError`	The file reference must exist to access the media and it cannot be empty.
`FileReferenceExpiredError`	The file reference has expired and is no longer valid or it belongs to self-destructing media and cannot be resent.
`GameBotInvalidError`	You cannot send that game with the current bot.
`InputUserDeactivatedError`	The specified user was deleted.
`MediaCaptionTooLongError`	The caption is too long.
`MediaEmptyError`	The provided media object is invalid or the current account may not be able to send it (such as games as users).
`PaymentProviderInvalidError`	The payment provider was not recognised or its token was invalid.
`PeerIdInvalidError`	An invalid Peer was used. Make sure to pass the right peer type and that the value is valid (for instance, bots cannot start conversations).
`PhotoExtInvalidError`	The extension of the photo is invalid.
`PhotoInvalidDimensionsError`	The photo dimensions are invalid (hint: `pip install pillow` for `send_file` to resize images).
`PhotoSaveFileInvalidError`	The photo you tried to send cannot be saved by Telegram. A reason may be that it exceeds 10MB. Try resizing it locally.
`PollAnswersInvalidError`	The poll did not have enough answers or had too many.
`PollOptionDuplicateError`	A duplicate option was sent in the same poll.
`PollQuestionInvalidError`	The poll question was either empty or too long.
`PostponedTimeoutError`	The postponed call has timed out.
`QuizCorrectAnswersEmptyError`	A quiz must specify one correct answer.
`QuizCorrectAnswersTooMuchError`	There can only be one correct answer.
`QuizCorrectAnswerInvalidError`	The correct answer is not an existing answer.
`QuizMultipleInvalidError`	A poll cannot be both multiple choice and quiz.
`RandomIdDuplicateError`	You provided a random ID that was already used.
`ScheduleDateTooLateError`	The date you tried to schedule is too far in the future (last known limit of 1 year and a few hours).
`ScheduleTooMuchError`	You cannot schedule more messages in this chat (last known limit of 100 per chat).
`StorageCheckFailedError`	Server storage check failed.
`TimeoutError`	A timeout occurred while fetching data from the worker.
`TopicDeletedError`	The topic was deleted.
`UserBannedInChannelError`	You're banned from sending messages in supergroups/channels.
`UserIsBlockedError`	User is blocked.
`UserIsBotError`	Bots can't send messages to other bots.
`VideoContentTypeInvalidError`	The video content type is not supported with the given parameters (i.e. supports_streaming).
`WebpageCurlFailedError`	Failure while fetching the webpage with cURL.
`WebpageMediaEmptyError`	Webpage media empty.

You can import these from telethon.errors.

Example

Please refer to the documentation of client.send_file() to learn about the parameters and see several code examples on how to use it.

The method above is the recommended way to do it. If you need more control over the parameters or want to learn how it is implemented, open the details by clicking on the "Details" text.

from telethon.sync import TelegramClient
from telethon import functions, types

with TelegramClient(name, api_id, api_hash) as client:
    result = client(functions.messages.SendMediaRequest(
        peer='username',
        media=types.InputMediaUploadedPhoto(
            file=client.upload_file('/path/to/file.jpg'),
            spoiler=True,
            stickers=[types.InputDocument(
                id=-12398745604826,
                access_hash=-12398745604826,
                file_reference=b'arbitrary\x7f data \xfa here'
            )],
            ttl_seconds=42
        ),
        message='Hello there!',
        noforwards=True,
        update_stickersets_order=True,
        invert_media=True,
        reply_to=types.InputReplyToMessage(
            reply_to_msg_id=42,
            top_msg_id=42,
            reply_to_peer_id='username',
            quote_text='some string here',
            quote_entities=[types.MessageEntityUnknown(
                offset=42,
                length=42
            )],
            quote_offset=42
        ),
        schedule_date=datetime.datetime(2018, 6, 25),
        send_as='username',
        quick_reply_shortcut=types.InputQuickReplyShortcut(
            shortcut='some string here'
        )
    ))
    print(result.stringify())