Skip to content

forwardMessages

Sahri Riza Umami edited this page Jul 2, 2018 · 3 revisions

Forwards previously sent messages.
Returns the forwarded messages in the same order as the message identifiers passed in message_ids.
If a message can't be forwarded, null will be returned instead of the message.

forwardMessages(chat_id, from_chat_id, message_ids, disable_notification, from_background, as_album, callback, data)
Field Type Description
chat_id int53 Identifier of a chat to forward messages.
from_chat_id int53 Identifier of the chat from which to forward messages.
message_ids vector<int53> Identifiers of the messages to forward.
disable_notification Bool Pass true to disable notification for the message, doesn't work if messages are forwarded to a secret chat.
from_background Bool Pass true if the message is sent from the background.
as_album Bool True, if the messages should be grouped into an album after forwarding. For this to work, no more than 10 messages may be forwarded, and all of them must be photo or video messages

Example

  • Forwards messages 16446914560, 16445865984 and 16444817408 from chat 1234567890 to chat 1234567890.

    forwardMessages(1234567890, 1234567890, {[0]=16446914560, 16445865984, 16444817408})

    Response:

    {
      ["@type"] = "messages",
      messages = {
        {
          ["@type"] = "message",
          author_signature = "",
          can_be_deleted_for_all_users = true,
          can_be_deleted_only_for_self = false,
          can_be_edited = false,
          can_be_forwarded = true,
          chat_id = 1234567890,
          contains_unread_mention = false,
          content = {
            ["@type"] = "messageText",
            text = {
              ["@type"] = "formattedText",
              entities = {},
              text = "TIGA"
            }
          },
          date = 1530515844,
          edit_date = 0,
          forward_info = {
            ["@type"] = "messageForwardedFromUser",
            date = 1530515527,
            forwarded_from_chat_id = 0,
            forwarded_from_message_id = 0,
            sender_user_id = 133780085
          },
          id = 16453206025,
          is_channel_post = false,
          is_outgoing = true,
          media_album_id = "0",
          reply_to_message_id = 0,
          sender_user_id = 133780085,
          sending_state = {
            ["@type"] = "messageSendingStatePending"
          },
          ttl = 0,
          ttl_expires_in = 0,
          via_bot_user_id = 0,
          views = 0
        },
        {
          ["@type"] = "message",
          author_signature = "",
          can_be_deleted_for_all_users = true,
          can_be_deleted_only_for_self = false,
          can_be_edited = false,
          can_be_forwarded = true,
          chat_id = 1234567890,
          contains_unread_mention = false,
          content = {
            ["@type"] = "messageText",
            text = {
              ["@type"] = "formattedText",
              entities = {},
              text = "DUA"
            }
          },
          date = 1530515844,
          edit_date = 0,
          forward_info = {
            ["@type"] = "messageForwardedFromUser",
            date = 1530515523,
            forwarded_from_chat_id = 0,
            forwarded_from_message_id = 0,
            sender_user_id = 133780085
          },
          id = 16453206033,
          is_channel_post = false,
          is_outgoing = true,
          media_album_id = "0",
          reply_to_message_id = 0,
          sender_user_id = 133780085,
          sending_state = {
            ["@type"] = "messageSendingStatePending"
          },
          ttl = 0,
          ttl_expires_in = 0,
          via_bot_user_id = 0,
          views = 0
        },
        {
          ["@type"] = "message",
          author_signature = "",
          can_be_deleted_for_all_users = true,
          can_be_deleted_only_for_self = false,
          can_be_edited = false,
          can_be_forwarded = true,
          chat_id = 1234567890,
          contains_unread_mention = false,
          content = {
            ["@type"] = "messageText",
            text = {
              ["@type"] = "formattedText",
              entities = {},
              text = "SATU"
            }
          },
          date = 1530515844,
          edit_date = 0,
          forward_info = {
            ["@type"] = "messageForwardedFromUser",
            date = 1530515519,
            forwarded_from_chat_id = 0,
            forwarded_from_message_id = 0,
            sender_user_id = 133780085
          },
          id = 16453206041,
          is_channel_post = false,
          is_outgoing = true,
          media_album_id = "0",
          reply_to_message_id = 0,
          sender_user_id = 133780085,
          sending_state = {
            ["@type"] = "messageSendingStatePending"
          },
          ttl = 0,
          ttl_expires_in = 0,
          via_bot_user_id = 0,
          views = 0
        }
      },
      total_count = 3
    }

Frequently Asked Questions
The Functions

Clone this wiki locally