Skip to main content

Темы (Forum Topics)

В супергруппах можно включить темы — отдельные разделы внутри одного чата. Каждое сообщение принадлежит одной теме (или общему «General»).

Включение​

Для группы (только владелец): Настройки группы → Темы → toggle.

После включения чат разбивается на темы, и сообщения нельзя писать «вне темы».

Создание темы​

POST /createForumTopic
{
  "chat_id": -100123,
  "name": "Технические вопросы",
  "icon_color": 7322096,
  "icon_custom_emoji_id": "5377522231104575574"
}

Ответ:

{
  "ok": true,
  "result": {
    "message_thread_id": 1234567890,
    "name": "Технические вопросы",
    "icon_color": 7322096
  }
}

message_thread_id — используется как параметр в sendMessage чтобы написать в эту тему.

Цвета иконок​

Стандартные цвета (Decimal RGB):

  • 7322096 — синий (#6FB9F0)
  • 16766590 — жёлтый (#FFD67E)
  • 13338331 — фиолетовый (#CB86DB)
  • 9367192 — зелёный (#8EEE98)
  • 16749490 — розовый (#FF93B2)
  • 16478047 — оранжевый (#FB6F5F)

Изменение​

POST /editForumTopic
{
  "chat_id": -100123,
  "message_thread_id": 1234,
  "name": "Новое название",
  "icon_custom_emoji_id": "..."
}

Закрыть / открыть​

Закрытая тема — read-only для не-админов:

POST /closeForumTopic
{ "chat_id": -100123, "message_thread_id": 1234 }

POST /reopenForumTopic
{ "chat_id": -100123, "message_thread_id": 1234 }

Удалить​

Удаляет тему и все сообщения в ней:

POST /deleteForumTopic
{ "chat_id": -100123, "message_thread_id": 1234 }

Открепить все в теме​

POST /unpinAllForumTopicMessages
{ "chat_id": -100123, "message_thread_id": 1234 }

Отправить в тему​

В sendMessage передайте message_thread_id:

{
  "chat_id": -100123,
  "message_thread_id": 1234,
  "text": "Сообщение в теме"
}