EnotPRO Logo EnotPRO

unhideGeneralForumTopic

unhideGeneralForumTopic — отображает скрытую общую тему (General) в группе-форуме.

📝 Назначение

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

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

  • Восстановление общего чата после временного отключения
  • Открытие доступа к общей теме для новых участников
  • Возврат к стандартному режиму работы форума

💡 Совет: Отображение темы не открывает её автоматически, если она была закрыта. Для открытия используйте reopengeneralforumtopic.

⚙️ Параметры

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

📍 Результат

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

${response.result}

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

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

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

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

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

Пример 1: Отображение скрытой общей темы

Задача: Показать общую тему, которая была скрыта ранее.

Параметры unhideGeneralForumTopic:

  • chat_id: ${chat.id}

Пример 2: Полное восстановление общей темы

Задача: Общая тема была скрыта. Нужно отобразить и открыть её.

Реакции:

  1. unhideGeneralForumTopicchat_id: ${chat.id} (отобразить)
  2. reopengeneralforumtopicchat_id: ${chat.id} (открыть)
  3. SendMessage → текст: Общая тема восстановлена и открыта для обсуждений.

Пример 3: Отображение общей темы по команде администратора

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

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

Реакции:

  1. unhideGeneralForumTopicchat_id: ${chat.id}
  2. SendMessage → текст: Общая тема отображена.

Пример 4: Отображение общей темы после скрытия по ошибке

Задача: Общая тема была скрыта ошибочно. Нужно вернуть её обратно.

Реакции:

  1. unhideGeneralForumTopicchat_id: ${chat.id}
  2. SendMessage → текст: Общая тема возвращена. Приносим извинения за неудобства.

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

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

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

Реакция Назначение
hidegeneralforumtopic Скрыть общую тему
closegeneralforumtopic Закрыть общую тему
reopengeneralforumtopic Открыть закрытую общую тему

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

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

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

unhideGeneralForumTopic — Telegram Bot API

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