CopyMessage

CopyMessage — реакция копирует сообщение в указанный чат или канал без ссылки на оригинал.

Назначение

Используется, когда нужно перенести содержимое сообщения, но не показывать, откуда оно взято. В отличие от ForwardMessage, у копии нет пометки «Переслано от», и её можно изменить: заменить подпись у медиа или убрать её совсем.

Реакция умеет копировать как одно сообщение, так и несколько сразу.

⚙️ Параметры

⚠️ Важно: Не перепутайте параметры! from_chat_id — это чат-источник, chat_id — это чат-получатель.

💡 Если оставить все три параметра пустыми, реакция скопирует текущее сообщение в текущий чат.

⚙️ Дополнительные параметры

Подпись поддерживает HTML-разметку. Во всех строковых параметрах работают макросы и переменные.

⚙️ Ответ на сообщение

💡 Если указан только reply_message_id, чат для ответа берётся из целевого чата. Опция reply_auto срабатывает только тогда, когда reply_chat_id и reply_message_id не заполнены вручную.

🔀 Копирование нескольких сообщений

В поле message_id можно перечислить несколько ID через запятую — например 101, 102, 103. В этом случае Telegram вызывается другим методом, у которого меньше возможностей.

⚠️ Важно: Список ID автоматически сортируется по возрастанию, а повторы убираются — этого требует Telegram. Порядок, в котором вы перечислили сообщения, значения не имеет.

🔐 Требуемые права бота

🧪 Примеры использования

Пример 1: Копия сообщения в технический чат

Задача: Скопировать сообщение пользователя в чат администраторов, не показывая, что это пересылка.

Реакция CopyMessage:

• from_chat_id: ${chat.id}
• chat_id: -100123456789 (технический чат)
• message_id: ${update.message.message_id}

Пример 2: Копия текущего сообщения без настроек

Задача: Продублировать сообщение в том же чате.

Реакция CopyMessage: все параметры оставить пустыми.

Пример 3: Копия медиа с новой подписью

Задача: Скопировать фото из канала, заменив подпись.

Реакция CopyMessage:

• from_chat_id: @channel_news
• chat_id: ${chat.id}
• message_id: 42
• caption: Новость дня: <b>читайте внимательно</b>

Пример 4: Копия без подписей

Задача: Перенести альбом из канала, убрав все подписи.

Реакция CopyMessage:

• from_chat_id: @channel_news
• chat_id: -100123456789
• message_id: 101, 102, 103
• remove_caption: true

Пример 5: Копия как ответ на текущее сообщение

Задача: Ответить пользователю копией сообщения из базы знаний.

Реакция CopyMessage:

• from_chat_id: @knowledge_base
• chat_id: ${chat.id}
• message_id: 15
• reply_auto: true

Пример 6: Копия в тему форума с защитой от пересылки

Реакция CopyMessage:

• from_chat_id: ${chat.id}
• chat_id: -100123456789 (группа-форум)
• message_id: ${update.message.message_id}
• topic_id: 42
• protect_content: true

🔄 Особенности поведения

⚠️ Ограничения Telegram

⚠️ Частые ошибки и их решение

Ошибка 1: chat_id empty или from_chat_id empty

Причина: Чат не указан и не определяется из контекста.

Решение: Заполните параметр явно или убедитесь, что реакция выполняется в контексте чата.

Ошибка 2: message_id empty

Причина: ID сообщения не указан, а текущего сообщения в контексте нет — например, реакция запущена по таймеру.

Решение: Укажите message_id явно.

Ошибка 3: Подпись не заменилась

Причина: Копируется несколько сообщений сразу — при копировании пачки подпись задать нельзя.

Решение: Копируйте сообщения по одному, отдельными реакциями.

Ошибка 4: Ответ не сработал

Причина: Указан список сообщений — при копировании пачки ответ не поддерживается.

Решение: Скопируйте нужное сообщение отдельной реакцией с reply_auto или reply_message_id.

🔗 Связанные реакции

🔗 Ссылка на официальную документацию

copyMessage — Telegram Bot API

copyMessages — Telegram Bot API