forward_messages()

Client.forward_messages()

转发指定消息。

参数:

entity (user | chat | channel):

接收消息的对象

message_ids (list | int | message, 可选):

要删除的消息 id 列表或者单个消息 id 或者消息对象。

from_peer (user | chat | channel):

指定转发消息的来源。如果 message_ids 传递的参数是数字。

silent (bool, 可选):

配置是否静默消息，默认关闭。

schedule (float, 可选):

配置是否定时消息，默认不配置。

返回:

message: 成功则将返回已转发的消息。（如果转发的是一组消息，则返回列表）

请注意：批量转发时，如果所有需要转发的消息都无效（即删除）则会抛出 MessageIdInvalidError 错误； 如果只有一些消息无效，则只是返回的列表中没有这些消息。

引发

MessageIdInvalidError – 如果消息的 ID 无效

示例

# 单条消息
await client.forward_messages(chat, message)
# 或者
await client.forward_messages(chat, message_id, from_chat)
# 或者
await message.forward_to(chat)

# 多条消息
await client.forward_messages(chat, messages)

# 作为一个副本发送（不带转发来源）
await client.send_message(chat, message)