EditGeneralForumTopic
EditGeneralForumTopic — изменяет название общей темы (General) в группе-форуме.
📝 Назначение
В группах-форумах есть специальная общая тема (General). Эта реакция позволяет изменить её отображаемое название.
Когда это нужно:
- Переименование общего чата в соответствии с тематикой форума
- Локализация названия общей темы
- Обновление названия после изменения назначения форума
💡 Совет: Название общей темы видно всем участникам. В отличие от обычных тем, общую тему нельзя удалить — только переименовать, закрыть или скрыть.
⚙️ Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| chat_id | Integer/String | ✅ Да | ID группы-форума или @username |
| name | String | ✅ Да | Новое название общей темы (1–128 символов) |
📍 Результат
После выполнения реакции результат доступен в переменной:
${response.result}
Тип значения: Boolean — true при успешном изменении названия.
🔐 Требуемые права бота
| Право | Описание |
|---|---|
| Бот — администратор чата | Обязательное условие |
| can_manage_topics | Право управлять темами форума |
⚠️ Важно: Для изменения названия общей темы бот должен быть администратором чата с правом
can_manage_topics.
🧪 Примеры использования
Пример 1: Изменение названия общей темы
Задача: Переименовать общую тему в «Общий чат».
Параметры EditGeneralForumTopic:
chat_id:${chat.id}name:Общий чат
Пример 2: Локализация названия
Задача: Установить английское название для общей темы.
Параметры EditGeneralForumTopic:
chat_id:${chat.id}name:General Discussion
Пример 3: Изменение названия по команде администратора
Задача: Администратор может изменить название общей темы командой /setgeneralname Новое название.
Обработчик: Регулярное выражение /setgeneralname (.+)
Реакции:
EditGeneralForumTopic→chat_id:${chat.id},name:${update.match.1}SendMessage→ текст:Название общей темы изменено на "${update.match.1}"
Пример 4: Автоматическое переименование при добавлении бота
Задача: При добавлении бота в форум установить стандартное название общей темы.
Обработчик: Тип my_chat_member (статус изменился на administrator или member)
Реакции:
EditGeneralForumTopic→chat_id:${chat.id},name:Чат под управлением бота
🔄 Особенности поведения
| Ситуация | Поведение |
|---|---|
| Название длиннее 128 символов | Telegram вернёт ошибку |
| Название короче 1 символа | Telegram вернёт ошибку |
| Бот не администратор | Реакция вызовет ошибку |
| У бота нет права can_manage_topics | Реакция вызовет ошибку |
| Чат не является форумом | Реакция вызовет ошибку |
🔗 Связанные реакции
| Реакция | Назначение |
|---|---|
| closegeneralforumtopic | Закрыть общую тему |
| hidegeneralforumtopic | Скрыть общую тему |
| reopengeneralforumtopic | Открыть закрытую общую тему |
| unhideGeneralForumTopic | Показать скрытую общую тему |
🔗 Связанные разделы
| Раздел | Описание |
|---|---|
| Топики | Общая информация о темах форума |