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