forwardMessages()

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 MessageId of the sent messages is returned.

parameters

parameter	type	required	description
`chat_id`	number \| string	required	Unique identifier for the target chat or username of the target bot, supergroup or channel in the format `@username`
`message_thread_id`	number	optional	Unique identifier for the target message thread (topic) of a forum; for forum supergroups and private chats of bots with forum topic mode enabled only
`direct_messages_topic_id`	number	optional	Identifier of the direct messages topic to which the messages will be forwarded; required if the messages are forwarded to a direct messages chat
`from_chat_id`	number \| string	required	Unique identifier for the chat where the original messages were sent (or username of the target bot, supergroup or channel in the format `@username`)
`message_ids`	number[]	required	A JSON-serialized list of 1-100 identifiers of messages in the chat from_chat_id to forward. The identifiers must be specified in a strictly increasing order.
`disable_notification`	boolean	optional	Sends the messages silently. Users will receive a notification with no sound.
`protect_content`	boolean	optional	Protects the contents of the forwarded messages from forwarding and saving

returns

MessageId[]

usage in yaebal

not (yet) hard-typed on Api — call it through the generic .call<T>() escape hatch documented in @yaebal/types.

bot.ts

import type { ForwardMessagesParams, MessageId } from "@yaebal/types";

await bot.api.call<MessageId[]>("forwardMessages", {
  chat_id: 123456789,
  from_chat_id: 123456789,
  message_ids: [],
} satisfies ForwardMessagesParams);

official Bot API docs: https://core.telegram.org/bots/api/#forwardmessages