mirror of
https://github.com/InsanusMokrassar/TelegramBotAPI-examples.git
synced 2026-05-08 17:40:02 +00: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.