EnotPRO Logo EnotPRO

EditGeneralForumTopic

EditGeneralForumTopic — изменяет название общей темы (General) в группе-форуме.

📝 Назначение

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

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

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

💡 Совет: Название общей темы видно всем участникам. В отличие от обычных тем, общую тему нельзя удалить — только переименовать, закрыть или скрыть.

⚙️ Параметры

Параметр Тип Обязательный Описание
chat_id Integer/String ✅ Да ID группы-форума или @username
name String ✅ Да Новое название общей темы (1–128 символов)

📍 Результат

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

${response.result}

Тип значения: Booleantrue при успешном изменении названия.

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

Право Описание
Бот — администратор чата Обязательное условие
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 (.+)

Реакции:

  1. EditGeneralForumTopicchat_id: ${chat.id}, name: ${update.match.1}
  2. SendMessage → текст: Название общей темы изменено на "${update.match.1}"

Пример 4: Автоматическое переименование при добавлении бота

Задача: При добавлении бота в форум установить стандартное название общей темы.

Обработчик: Тип my_chat_member (статус изменился на administrator или member)

Реакции:

  1. EditGeneralForumTopicchat_id: ${chat.id}, name: Чат под управлением бота

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

Ситуация Поведение
Название длиннее 128 символов Telegram вернёт ошибку
Название короче 1 символа Telegram вернёт ошибку
Бот не администратор Реакция вызовет ошибку
У бота нет права can_manage_topics Реакция вызовет ошибку
Чат не является форумом Реакция вызовет ошибку

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

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

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

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

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

editGeneralForumTopic — Telegram Bot API

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