EnotPRO Logo EnotPRO

editforumtopic

editforumtopic — изменяет название и/или иконку существующей темы в группе-форуме.

📝 Назначение

Используется для редактирования параметров уже созданной темы: изменения названия или замены иконки (цвет или пользовательский эмодзи).

Когда это нужно:

  • Переименовать тему в соответствии с новым содержанием
  • Сменить иконку темы для лучшей визуальной идентификации
  • Обновить название темы после изменения её назначения

💡 Совет: Для изменения иконки можно использовать как предустановленные цвета, так и пользовательские эмодзи. Цвета задаются числовыми значениями (см. createforumtopic).

⚙️ Параметры

Параметр Тип Обязательный Описание
chat_id Integer/String ✅ Да ID группы-форума или @username
message_thread_id Integer ✅ Да ID темы (получается при создании через createforumtopic)
name String ❌ Нет Новое название темы (1–128 символов)
icon_custom_emoji_id String ❌ Нет ID пользовательского эмодзи для иконки (если указан — заменяет цвет)

⚠️ Важно: Для сброса пользовательского эмодзи и возврата к цветовой иконке передайте пустую строку ("") в параметре icon_custom_emoji_id.

📍 Результат

После выполнения реакции результат доступен в переменной:

${response.result}

Тип значения: Booleantrue при успешном изменении.

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

Ситуация Требуемые права
Бот — создатель темы Права не требуются (может редактировать свои темы)
Бот — администратор чата Право can_manage_topics
Бот — не создатель и не администратор Редактирование невозможно

💡 Совет: Если бот создал тему через createforumtopic, он может редактировать её без прав администратора.

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

Пример 1: Изменение названия темы

Задача: Переименовать тему с ID 12345 в «Важные обновления».

Параметры editforumtopic:

  • chat_id: ${chat.id}
  • message_thread_id: 12345
  • name: Важные обновления

Пример 2: Установка иконки через пользовательский эмодзи

Задача: Установить для темы иконку 📰.

Параметры editforumtopic:

  • chat_id: ${chat.id}
  • message_thread_id: 12345
  • icon_custom_emoji_id: 5434144690511290129

Пример 3: Сброс пользовательского эмодзи

Задача: Убрать пользовательский эмодзи, вернуть цветовую иконку.

Параметры editforumtopic:

  • chat_id: ${chat.id}
  • message_thread_id: 12345
  • icon_custom_emoji_id: `` (пустая строка)

Пример 4: Полное редактирование (название + иконка)

Задача: Изменить и название, и иконку темы.

Параметры editforumtopic:

  • chat_id: ${chat.id}
  • message_thread_id: 12345
  • name: Срочные новости
  • icon_custom_emoji_id: 5434144690511290129

Пример 5: Редактирование темы, созданной ботом

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

Реакции:

  1. createforumtopic → создание темы, сохранение message_thread_id
  2. editforumtopic
  • chat_id: ${chat.id}
  • message_thread_id: ${saved_thread_id}
  • name: Новое название

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

Ситуация Поведение
Тема не существует Telegram вернёт ошибку
Название длиннее 128 символов Telegram вернёт ошибку
Название короче 1 символа Telegram вернёт ошибку
Бот не создатель и не администратор Реакция вызовет ошибку
У бота нет права can_manage_topics (если не создатель) Реакция вызовет ошибку
Передан некорректный icon_custom_emoji_id Иконка не изменится

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

Реакция Назначение
createforumtopic Создать новую тему
closeforumtopic Закрыть тему
deleteforumtopic Удалить тему
GetForumTopicIconStickers Получить ID эмодзи для иконки

🔗 Связанные разделы

Раздел Описание
Топики Общая информация о темах форума

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

editForumTopic — Telegram Bot API

© 2025 EnotPRO. Все права защищены.