Files
TelegramBotAPI-examples/TopicsHandling
2026-05-07 17:18:24 +06:00
..
2026-02-16 17:40:23 +06:00
2022-12-31 15:45:48 +06:00
2026-05-07 17:18:24 +06:00

TopicsHandling

A bot that demonstrates full forum-topic management for Telegram supergroups with forum mode enabled.

Functionality

Provides commands to create, edit, close, reopen, and delete forum topics. Also handles the general topic (hide/unhide, close/reopen, pin/unpin messages) and listens for all topic lifecycle events, logging each one.

Arguments

Position Value Description
1 BOT_TOKEN Telegram bot token

Optional arguments (any order after the token):

Value Description
debug Enable verbose debug logging
testServer Connect to the Telegram test server instead of production

Bot Commands

Command Description
/start_test_topics Runs a full test sequence: creates a topic, edits its name and icon, pins a message, closes and reopens it, then deletes it
/delete_topic Deletes the forum topic in which the command was sent
/unpin_all_forum_topic_messages Unpins all messages in the current forum topic

Capabilities

  • Creates colour-coded forum topics with a custom emoji icon
  • Edits topic name and icon
  • Closes and reopens topics
  • Deletes topics
  • Manages the general (default) topic: hide, unhide, close, reopen
  • Pins and unpins messages within a topic
  • Detects and logs topic creation, editing, closure, reopening, and general-topic visibility changes
  • Detects private forum support and enables private topics when available
  • Runs via long polling

Launch

../gradlew run --args="BOT_TOKEN"

Note: The bot must be an administrator with Manage Topics permission in the target supergroup.