CopyMessages
extends TelegramMethod
in package
Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessages, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of MessageId of the sent messages is returned.
Source: https://core.telegram.org/bots/api#copymessages
Tags
Table of Contents
Constants
- ApiMethod : string = 'copyMessages'
- ReturnsType : string = 'list:MessageId'
- Subclasses override with either: - a `class-string<TelegramObject>` (e.g. Message::class) for object returns - a scalar type name ('bool', 'int', 'string') for primitive returns - 'list:<inner>' for array returns
Properties
- $bot : Bot|null
- $chatId : int|string
- $directMessagesTopicId : int|null
- $disableNotification : bool|null
- $fromChatId : int|string
- $messageIds : array<int, int>
- $messageThreadId : int|null
- $protectContent : bool|null
- $removeCaption : bool|null
Methods
- __construct() : mixed
- as_() : static
- Alias of withBot() for grep-translating aiogram code that uses obj.as_(bot).
- bindBot() : static
- Returns a clone bound to $bot. Used by hand-authored shortcut methods (Message::answer, etc.) so the chained ->emit() picks up the bot without an explicit argument.
- emit() : TReturn
- Emit this method via the bound bot (or the explicitly-passed bot).
- withBot() : static
- Returns a clone of $this with $bot rebound recursively. Walks every public property; nested `BotContextController` instances are rebound via their own `withBot`, arrays (including nested arrays of arbitrary depth — e.g.
Constants
ApiMethod
public
string
ApiMethod
= 'copyMessages'
ReturnsType
Subclasses override with either: - a `class-string<TelegramObject>` (e.g. Message::class) for object returns - a scalar type name ('bool', 'int', 'string') for primitive returns - 'list:<inner>' for array returns
public
string
ReturnsType
= 'list:MessageId'
Stays '' on the abstract base — Phase 2 codegen sets it per concrete method.
Properties
$bot read-only
public
Bot|null
$bot
= null
$chatId read-only
public
int|string
$chatId
$directMessagesTopicId read-only
public
int|null
$directMessagesTopicId
= null
$disableNotification read-only
public
bool|null
$disableNotification
= null
$fromChatId read-only
public
int|string
$fromChatId
$messageIds read-only
public
array<int, int>
$messageIds
$messageThreadId read-only
public
int|null
$messageThreadId
= null
$protectContent read-only
public
bool|null
$protectContent
= null
$removeCaption read-only
public
bool|null
$removeCaption
= null
Methods
__construct()
public
__construct(int|string $chatId, int|string $fromChatId, array<string|int, mixed> $messageIds[, int|null $messageThreadId = null ][, int|null $directMessagesTopicId = null ][, bool|null $disableNotification = null ][, bool|null $protectContent = null ][, bool|null $removeCaption = null ][, Bot|null $bot = null ]) : mixed
Parameters
- $chatId : int|string
- $fromChatId : int|string
- $messageIds : array<string|int, mixed>
- $messageThreadId : int|null = null
- $directMessagesTopicId : int|null = null
- $disableNotification : bool|null = null
- $protectContent : bool|null = null
- $removeCaption : bool|null = null
- $bot : Bot|null = null
as_()
Alias of withBot() for grep-translating aiogram code that uses obj.as_(bot).
public
as_(Bot|null $bot) : static
IMPORTANT: behaves DIFFERENTLY from upstream — upstream mutates self.bot in place and returns self. The PHP port can't mutate readonly, so this returns a clone. Callers must reassign: $msg = $msg->as($bot).
Parameters
- $bot : Bot|null
Return values
staticbindBot()
Returns a clone bound to $bot. Used by hand-authored shortcut methods (Message::answer, etc.) so the chained ->emit() picks up the bot without an explicit argument.
public
bindBot(Bot|null $bot) : static
Parameters
- $bot : Bot|null
Return values
staticemit()
Emit this method via the bound bot (or the explicitly-passed bot).
public
emit([Bot|null $bot = null ]) : TReturn
Mirrors upstream methods/base.py:81-93 (await + emit).
Parameters
- $bot : Bot|null = null
Return values
TReturnwithBot()
Returns a clone of $this with $bot rebound recursively. Walks every public property; nested `BotContextController` instances are rebound via their own `withBot`, arrays (including nested arrays of arbitrary depth — e.g.
public
withBot(Bot|null $bot) : static
list<list<KeyboardButton>>) are walked element-wise. Plain values
(scalars, DateTime, enums, InputFile etc.) pass through untouched.
Mirrors upstream pydantic model_validate(context={"bot": bot}) (aiogram
ContextController.as_/model_dump_json+model_validate).
Scope note: PHP 8.5 treats public readonly as effectively
public protected(set) readonly for clone-with — only code running with
a scope in the property's declaring class hierarchy (declaring class plus
its ancestors and descendants) can use clone($obj, ['x' => ...]) against
it. Because this method lives on BotContextController and every
TelegramObject/TelegramMethod subclass extends it, the walker's
clone($this, [...]) call legally rewrites subclass-declared readonly
slots like Message::$chat. External callers cannot use the same syntax
— they must funnel through this method.
Parameters
- $bot : Bot|null