MadelineProtoDocs/old_docs/API_docs_v73/methods/messages.sendMedia.md
2019-12-27 18:46:25 +01:00

3.9 KiB

title description image redirect_from
messages.sendMedia Send a media https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png /API_docs/methods/messages_sendMedia.html

Method: messages.sendMedia

Back to methods index

Send a media

Parameters:

Name Type Description Required
silent Bool Send message silently (no notification should be triggered) Optional
background Bool Send message in background Optional
clear_draft Bool Clear the draft Optional
peer Username, chat ID, Update, Message or InputPeer Destination Optional
reply_to_msg_id int Message ID to which this message should reply to Optional
media MessageMedia, Update, Message or InputMedia Attached media Optional
reply_markup ReplyMarkup Reply markup for bot keyboards Optional

Return type: Updates

Can bots use this method: YES

MadelineProto Example (now async for huge speed and parallelism!):

if (!file_exists('madeline.php')) {
    copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
}
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');
$MadelineProto->start();

$Updates = $MadelineProto->messages->sendMedia(['silent' => Bool, 'background' => Bool, 'clear_draft' => Bool, 'peer' => InputPeer, 'reply_to_msg_id' => int, 'media' => InputMedia, 'reply_markup' => ReplyMarkup, ]);

Or, if you're into Lua:

Updates = messages.sendMedia({silent=Bool, background=Bool, clear_draft=Bool, peer=InputPeer, reply_to_msg_id=int, media=InputMedia, reply_markup=ReplyMarkup, })

Usage of reply_markup

You can provide bot API reply_markup objects here.

Errors

Code Type Description
400 BUTTON_DATA_INVALID The data of one or more of the buttons you provided is invalid
400 BUTTON_TYPE_INVALID The type of one or more of the buttons you provided is invalid
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_RESTRICTED You can't send messages in this chat, you were restricted
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 IMAGE_PROCESS_FAILED Failure while processing image
400 INPUT_USER_DEACTIVATED The specified user was deleted
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 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 REPLY_MARKUP_BUY_EMPTY Reply markup for buy button empty
400 USER_BANNED_IN_CHANNEL You're banned from sending messages in supergroups/channels
400 USER_IS_BLOCKED You were blocked by this user
400 USER_IS_BOT Bots can't send messages to other bots
400 WEBPAGE_CURL_FAILED Failure while fetching the webpage with cURL
400 WEBPAGE_MEDIA_EMPTY Webpage media empty
400 YOU_BLOCKED_USER You blocked this user
403 CHAT_SEND_MEDIA_FORBIDDEN You can't send media in this chat
403 CHAT_WRITE_FORBIDDEN You can't write in this chat
420 SLOWMODE_WAIT_X Slowmode is enabled in this chat: you must wait for the specified number of seconds before sending another message to the chat.
-503 Timeout Timeout while fetching data