forwardMessages#

Returns: List[MessageId]

class aiogram.methods.forward_messages.ForwardMessages(*, chat_id: int | str, from_chat_id: int | str, message_ids: List[int], message_thread_id: int | None = None, disable_notification: bool | None = None, protect_content: bool | None = None, **extra_data: Any)[source]#

Use this method to forward multiple messages of any kind. If some of the specified messages can’t be found or forwarded, they are skipped. Service messages and messages with protected content can’t be forwarded. Album grouping is kept for forwarded messages. On success, an array of aiogram.types.message_id.MessageId of the sent messages is returned.

Source: https://core.telegram.org/bots/api#forwardmessages

chat_id: int | str#

Unique identifier for the target chat or username of the target channel (in the format @channelusername)

from_chat_id: int | str#

Unique identifier for the chat where the original messages were sent (or channel username in the format @channelusername)

message_ids: List[int]#

Identifiers of 1-100 messages in the chat from_chat_id to forward. The identifiers must be specified in a strictly increasing order.

message_thread_id: int | None#

Unique identifier for the target message thread (topic) of the forum; for forum supergroups only

disable_notification: bool | None#

Sends the messages silently. Users will receive a notification with no sound.

protect_content: bool | None#

Protects the contents of the forwarded messages from forwarding and saving

Usage#

As bot method#

result: List[MessageId] = await bot.forward_messages(...)

Method as object#

Imports:

  • from aiogram.methods.forward_messages import ForwardMessages

  • alias: from aiogram.methods import ForwardMessages

With specific bot#

result: List[MessageId] = await bot(ForwardMessages(...))

As reply into Webhook in handler#

return ForwardMessages(...)