messages.forwardMessages

Forwards messages by their IDs.

func (c *Client) MessagesForwardMessages(ctx context.Context, request *MessagesForwardMessagesRequest) (UpdatesClass, error)

Calling this method

client.Run(ctx, func(ctx context.Context) error {
	api := client.API()
	
	res, err := api.MessagesForwardMessages(ctx, &tg.MessagesForwardMessagesRequest{
		// see Parameters
	})
	if err != nil {
		return err
	}
	_ = res // UpdatesClass
	return nil
})

Parameters

Name	Type	Required	Description
Silent	bool	—	Whether to send messages silently (no notification will be triggered on the destination clients)
Background	bool	—	Whether to send the message in background
WithMyScore	bool	—	When forwarding games, whether to include your score in the game
DropAuthor	bool	—	Whether to forward messages without quoting the original author
DropMediaCaptions	bool	—	Whether to strip captions from media
Noforwards	bool	—	Only for bots, disallows further re-forwarding and saving of the messages, even if the destination chat doesn't have content protection enabled
AllowPaidFloodskip	bool	—	Bots only: if set, allows sending up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance.
FromPeer	InputPeerClass	yes	Source of messages
ID	[]int	yes	IDs of messages
RandomID	[]int64	yes	Random ID to prevent resending of messages
ToPeer	InputPeerClass	yes	Destination peer
TopMsgID	int	—	Destination forum topic
ReplyTo	InputReplyToClass	—	Can only contain an inputReplyToMonoForum, to forward messages to a monoforum topic (mutually exclusive with top_msg_id).
ScheduleDate	int	—	Scheduled message date for scheduled messages
ScheduleRepeatPeriod	int	—	Once sent, this message will be automatically re-scheduled to be re-sent again this many seconds in the future, see here » for more info on repeating scheduled messages.
SendAs	InputPeerClass	—	Forward the messages as the specified peer
QuickReplyShortcut	InputQuickReplyShortcutClass	—	Add the messages to the specified quick reply shortcut », instead.
Effect	int64	—	Specifies a message effect » to use for the message.
VideoTimestamp	int	—	Start playing the video at the specified timestamp (seconds).
AllowPaidStars	int64	—	For paid messages », specifies the amount of Telegram Stars the user has agreed to pay in order to send the message.
SuggestedPost	SuggestedPost	—	Used to suggest a post to a channel, see here » for more info on the full flow.

Returns

UpdatesClass

Possible errors

Code	Type	Description
406	ALLOW_PAYMENT_REQUIRED	This peer only accepts paid messages »: this error is only emitted for older layers without paid messages support, so the client must be updated in order to use paid messages. .
400	BROADCAST_PUBLIC_VOTERS_FORBIDDEN	You can't forward polls with public voters.
400	CHANNEL_INVALID	The provided channel is invalid.
406	CHANNEL_PRIVATE	You haven't joined this channel/supergroup.
403	CHAT_ADMIN_REQUIRED	You must be an admin in this chat to do this.
406	CHAT_FORWARDS_RESTRICTED	You can't forward messages from a protected chat.
403	CHAT_GUEST_SEND_FORBIDDEN	You join the discussion group before commenting, see here » for more info.
400	CHAT_ID_INVALID	The provided chat id is invalid.
400	CHAT_RESTRICTED	You can't send messages in this chat, you were restricted.
403	CHAT_SEND_AUDIOS_FORBIDDEN	You can't send audio messages in this chat.
403	CHAT_SEND_DOCS_FORBIDDEN	You can't send documents in this chat.
403	CHAT_SEND_GAME_FORBIDDEN	You can't send a game to this chat.
403	CHAT_SEND_GIFS_FORBIDDEN	You can't send gifs in this chat.
403	CHAT_SEND_INLINE_FORBIDDEN	You can't send inline messages in this group.
403	CHAT_SEND_MEDIA_FORBIDDEN	You can't send media in this chat.
403	CHAT_SEND_PHOTOS_FORBIDDEN	You can't send photos in this chat.
403	CHAT_SEND_PLAIN_FORBIDDEN	You can't send non-media (text) messages 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_SEND_VIDEOS_FORBIDDEN	You can't send videos in this chat.
403	CHAT_SEND_VOICES_FORBIDDEN	You can't send voice recordings in this chat.
403	CHAT_SEND_WEBPAGE_FORBIDDEN	You can't send webpage previews to this chat.
403	CHAT_WRITE_FORBIDDEN	You can't write in this chat.
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_IDS_EMPTY	No message ids were provided.
400	MESSAGE_ID_INVALID	The provided message id is invalid.
400	MSG_ID_INVALID	Invalid message ID provided.
500	NEED_DOC_INVALID
406	PAYMENT_UNSUPPORTED	A detailed description of the error will be received separately as described here ».
406	PEER_ID_INVALID	The provided peer id is invalid.
403	PREMIUM_ACCOUNT_REQUIRED	A premium account is required to execute this action.
406	PRIVACY_PREMIUM_REQUIRED	You need a Telegram Premium subscription to send a message to this user.
400	QUICK_REPLIES_BOT_NOT_ALLOWED	Quick replies cannot be used by bots.
400	QUICK_REPLIES_TOO_MUCH	A maximum of appConfig.quick_replies_limit shortcuts may be created, the limit was reached.
400	QUIZ_ANSWER_MISSING	You can forward a quiz while hiding the original author only after choosing an option in the quiz.
500	RANDOM_ID_DUPLICATE	You provided a random ID that was already used.
400	RANDOM_ID_INVALID	A provided random ID is invalid.
400	REPLY_MESSAGES_TOO_MUCH	Each shortcut can contain a maximum of appConfig.quick_reply_messages_limit messages, the limit was reached.
400	REPLY_TO_MONOFORUM_PEER_INVALID	The specified inputReplyToMonoForum.monoforum_peer_id is invalid.
400	SCHEDULE_BOT_NOT_ALLOWED	Bots cannot schedule messages.
400	SCHEDULE_DATE_TOO_LATE	You can't schedule a message this far in the future.
400	SCHEDULE_TOO_MUCH	There are too many scheduled messages.
400	SEND_AS_PEER_INVALID	You can't send messages as the specified peer.
400	SLOWMODE_MULTI_MSGS_DISABLED	Slowmode is enabled, you cannot forward multiple messages to this group.
400	SUGGESTED_POST_PEER_INVALID	You cannot send suggested posts to non-monoforum peers.
406	TOPIC_CLOSED	This topic was closed, you can't send messages to it anymore.
406	TOPIC_DELETED	The specified topic was deleted.
400	USER_BANNED_IN_CHANNEL	You're banned from sending messages in supergroups/channels.
403	USER_IS_BLOCKED	You were blocked by this user.
400	USER_IS_BOT	Bots can't send messages to other bots.
403	VOICE_MESSAGES_FORBIDDEN	This user's privacy settings forbid you from sending voice messages.
400	YOU_BLOCKED_USER	You blocked this user.

References

• Official documentation
• Generated Go reference
• TL definition: messages.forwardMessages#13704a7c