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