EnotPRO Logo EnotPRO

hidegeneralforumtopic

hidegeneralforumtopic — скрывает общую тему (General) в группе-форуме от участников.

📝 Назначение

В группах-форумах есть специальная общая тема (General). Эта реакция скрывает её из списка тем для всех участников (кроме администраторов). Если тема была открыта, она автоматически закрывается перед скрытием.

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

  • Полное отключение общего чата
  • Перенаправление пользователей в специализированные темы
  • Упрощение навигации по форуму

💡 Совет: Скрытую тему можно вновь отобразить через unhideGeneralForumTopic. При скрытии тема автоматически закрывается, поэтому отдельно вызывать closegeneralforumtopic не нужно.

⚙️ Параметры

Параметр Тип Обязательный Описание
chat_id Integer/String ✅ Да ID группы-форума или @username

📍 Результат

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

${response.result}

Тип значения: Booleantrue при успешном скрытии общей темы.

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

Право Описание
Бот — администратор чата Обязательное условие
can_manage_topics Право управлять темами форума

⚠️ Важно: Для скрытия общей темы бот должен быть администратором чата с правом can_manage_topics.

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

Пример 1: Скрытие общей темы

Задача: Скрыть общую тему в форуме.

Параметры hidegeneralforumtopic:

  • chat_id: ${chat.id}

Пример 2: Полное отключение общего чата

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

Реакции:

  1. hidegeneralforumtopicchat_id: ${chat.id} (тема скроется и автоматически закроется)
  2. SendMessage → текст: Общая тема отключена. Пожалуйста, создавайте отдельные темы для каждого вопроса.

Пример 3: Скрытие общей темы при нарушении правил

Задача: При массовом нарушении правил скрыть общую тему.

Реакции:

  1. (Обнаружение нарушения)
  2. hidegeneralforumtopicchat_id: ${chat.id}
  3. SendMessage → текст: Общая тема временно скрыта из-за нарушения правил.

Пример 4: Скрытие общей темы по команде администратора

Задача: Администратор может скрыть общую тему командой /hidegeneral.

Обработчик: Команда /hidegeneral

Реакции:

  1. hidegeneralforumtopicchat_id: ${chat.id}
  2. SendMessage → текст: Общая тема скрыта.

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

Ситуация Поведение
Общая тема уже скрыта Повторное скрытие не вызывает ошибку (ничего не меняется)
Общая тема была открыта Автоматически закрывается перед скрытием
Бот не администратор Реакция вызовет ошибку
У бота нет права can_manage_topics Реакция вызовет ошибку
Чат не является форумом Реакция вызовет ошибку

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

Реакция Назначение
unhideGeneralForumTopic Показать скрытую общую тему
closegeneralforumtopic Закрыть общую тему (без скрытия)
reopengeneralforumtopic Открыть закрытую общую тему

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

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

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

hideGeneralForumTopic — Telegram Bot API

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