Обзор и объекты

Bot API позволяет ботам читать топики группы, отправлять сообщения в выбранный топик и управлять топиками при наличии прав.

Требования

• Бот должен состоять в группе.
• В группе должен быть включён режим топиков.
• Для редактирования, закрытия, повторного открытия и удаления требуется право manage_topics.
• Создание доступно согласно настройке группы topics_create: всем участникам или администраторам.

Идентификатор топика

Во всех методах используется message_thread_id. Для совместимости API также принимает topic_id, но в новых интеграциях рекомендуется использовать message_thread_id.

Объект ForumTopic

{
  "message_thread_id": 42,
  "name": "Поддержка",
  "icon_color": "#6C8CFF",
  "icon_emoji": "🛠",
  "creator_id": 15,
  "is_general": false,
  "is_closed": false,
  "message_count": 18,
  "created_at": "2026-08-11 10:00:00",
  "updated_at": "2026-08-11 10:30:00"
}

Объект Chat

Метод getChat дополнительно возвращает:

{
  "is_forum": true,
  "topics_create": "admins"
}

topics_create принимает значение all или admins.

Общий топик

Общий топик создаётся автоматически при включении режима топиков. Если при отправке сообщения не передать message_thread_id, Bot API отправит его в общий топик. Общий топик нельзя удалить.

Ошибки