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}
Тип значения: Boolean — true при успешном изменении.
🔐 Требуемые права бота
| Ситуация | Требуемые права |
|---|---|
| Бот — создатель темы | Права не требуются (может редактировать свои темы) |
| Бот — администратор чата | Право can_manage_topics |
| Бот — не создатель и не администратор | Редактирование невозможно |
💡 Совет: Если бот создал тему через
createforumtopic, он может редактировать её без прав администратора.
🧪 Примеры использования
Пример 1: Изменение названия темы
Задача: Переименовать тему с ID 12345 в «Важные обновления».
Параметры editforumtopic:
chat_id:${chat.id}message_thread_id:12345name:Важные обновления
Пример 2: Установка иконки через пользовательский эмодзи
Задача: Установить для темы иконку 📰.
Параметры editforumtopic:
chat_id:${chat.id}message_thread_id:12345icon_custom_emoji_id:5434144690511290129
Пример 3: Сброс пользовательского эмодзи
Задача: Убрать пользовательский эмодзи, вернуть цветовую иконку.
Параметры editforumtopic:
chat_id:${chat.id}message_thread_id:12345icon_custom_emoji_id: `` (пустая строка)
Пример 4: Полное редактирование (название + иконка)
Задача: Изменить и название, и иконку темы.
Параметры editforumtopic:
chat_id:${chat.id}message_thread_id:12345name:Срочные новостиicon_custom_emoji_id:5434144690511290129
Пример 5: Редактирование темы, созданной ботом
Задача: Бот создал тему и теперь редактирует её без прав администратора.
Реакции:
createforumtopic→ создание темы, сохранениеmessage_thread_ideditforumtopic→
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 эмодзи для иконки |
🔗 Связанные разделы
| Раздел | Описание |
|---|---|
| Топики | Общая информация о темах форума |