MadelineProtoDocs/old_docs/API_docs_v33/methods/messages.forwardMessages.md
2020-06-16 17:50:25 +02:00

3.8 KiB

title description image redirect_from
messages.forwardMessages Forwards messages by their IDs. https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png /API_docs/methods/messages_forwardMessages.html

Method: messages.forwardMessages

Back to methods index

Forwards messages by their IDs.

Parameters:

Name Type Description Required
silent Bool Whether to send messages silently (no notification will be triggered on the destination clients) Optional
background Bool Whether to send the message in background Optional
with_my_score Bool When forwarding games, whether to include your score in the game Optional
grouped Bool Whether the specified messages represent an album (grouped media) Optional
from_peer Username, chat ID, Update, Message or InputPeer Source of messages Optional
id Array of int IDs of messages Yes
to_peer Username, chat ID, Update, Message or InputPeer Destination peer 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->forwardMessages(['silent' => Bool, 'background' => Bool, 'with_my_score' => Bool, 'grouped' => Bool, 'from_peer' => InputPeer, 'id' => [int, int], 'to_peer' => InputPeer, ]);

Or, if you're into Lua:

Updates = messages.forwardMessages({silent=Bool, background=Bool, with_my_score=Bool, grouped=Bool, from_peer=InputPeer, id={int}, to_peer=InputPeer, })

Errors

Code Type Description
400 BROADCAST_PUBLIC_VOTERS_FORBIDDEN You can't forward polls with public voters
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_ID_INVALID The provided chat id is invalid
400 CHAT_RESTRICTED You can't send messages in this chat, you were restricted
400 GROUPED_MEDIA_INVALID Invalid grouped media
400 INPUT_USER_DEACTIVATED The specified user was deleted
400 MEDIA_EMPTY The provided media object is invalid
400 MESSAGE_ID_INVALID The provided message id is invalid
400 MESSAGE_IDS_EMPTY No message ids were provided
400 MSG_ID_INVALID Invalid message ID provided
400 PEER_ID_INVALID The provided peer id is invalid
400 RANDOM_ID_INVALID A provided random ID is invalid
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 YOU_BLOCKED_USER You blocked this user
406 AUTH_KEY_DUPLICATED An auth key with the same ID was already generated
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_POLL_FORBIDDEN You can't send polls in this chat
403 CHAT_SEND_STICKERS_FORBIDDEN You can't send stickers 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