createforumtopic

createforumtopic — создаёт новую тему (топик) в группе-форуме или в личном чате с пользователем.

📝 Назначение

Используется для программного создания тем в супергруппах, где включён режим форума. Каждая тема функционирует как отдельный чат со своими настройками уведомлений и возможностью закреплять сообщения.

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

• Автоматическое создание темы под каждый заказ или тикет
• Организация обсуждений по категориям
• Создание временных тем для мероприятий

💡 Совет: После создания темы её идентификатор (message_thread_id) используется в других реакциях для отправки сообщений именно в эту тему.

⚙️ Параметры

🎨 Допустимые значения icon_color

💡 Совет: Для получения ID пользовательских эмодзи используйте реакцию GetForumTopicIconStickers.

📍 Результат

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

${response.result}

Структура результата — объект ForumTopic:

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

⚠️ Важно: Для создания темы в группе-форуме бот должен быть администратором с правом can_manage_topics.

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

Пример 1: Создание простой темы

Задача: Создать тему «Общие вопросы» с цветом по умолчанию.

Параметры createforumtopic:

• chat_id: ${chat.id}
• name: Общие вопросы

Пример 2: Создание темы с указанным цветом

Задача: Создать тему с зелёной иконкой.

Параметры createforumtopic:

• chat_id: ${chat.id}
• name: Важные объявления
• icon_color: 9367192

Пример 3: Создание темы с пользовательским эмодзи

Задача: Создать тему с эмодзи 📰 в качестве иконки.

Параметры createforumtopic:

• chat_id: ${chat.id}
• name: Новости
• icon_custom_emoji_id: 5434144690511290129

Пример 4: Использование ID созданной темы

Задача: Создать тему и отправить в неё приветственное сообщение.

Реакции:

1. createforumtopic → chat_id: ${chat.id}, name: Поддержка
2. SendMessage →

• chat_id: ${chat.id}
• topic_id: ${response.result.message_thread_id}
• Текст: Добро пожаловать в тему поддержки!

Пример 5: Создание темы по команде

Задача: Администратор может создать тему командой /newtopic Название темы.

Обработчик: Регулярное выражение /newtopic (.+)

Реакции:

1. createforumtopic → chat_id: ${chat.id}, name: ${update.match.1}
2. SendMessage → текст: Тема "${update.match.1}" создана!

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

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

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