mirror of
https://github.com/InsanusMokrassar/TelegramBotAPI-examples.git
synced 2026-05-10 18:40:04 +00:00
51 lines
1.7 KiB
Markdown
51 lines
1.7 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
../gradlew run --args="BOT_TOKEN"
|
|
```
|
|
|
|
> **Note:** The bot must be an administrator with *Manage Topics* permission in the target supergroup.
|