Setup Topics for a Forwarding Task
This guide explains how to choose topics for a forwarding task and how to use Topic Sync.
What Is Topic Setup?
Topic setup lets you control which topics receive forwarded messages.
Source topics: topics where messages are read.
Target topics: topics where messages are forwarded.
You can create more than one source-to-target mapping.
Set Up Topics Manually
Open your forwarding task.
Open Set Up Forward Topics.
Expand Manual topic mapping.
In a mapping row, tap Add Source Topics.
Search for a group or topic, then select one or more topics.
Tap Done.
Tap Add Target Topics and select the target topic or topics.
Tap Add More Forward Topics to create another mapping row if needed.
Tap Save on the setup screen.
You can remove a selected topic with the remove icon. To remove a complete mapping row, use the close icon on that row.
Selecting Topics
The topic selection screen provides:
Search by group name or chat ID.
Filters for All, Group, Channel, Bot, and User.
Multiple topic selection.
An option to select all topics in the listed groups.
Reload for a group when the topic list is out of date.
When you select specific topics in a group, the all-topics option for that group is replaced by the specific selection.
If a group has no topics, enable Topics in Telegram first, then reload the group.
Add a Missing Topic
If a topic is not returned by Telegram, tap Add Topic for the group and enter its topic ID and name. Then select it and tap Done.
What Is Topic Sync?
Topic Sync automatically keeps topics aligned between your source and target groups in a forwarding task.
New source topics are created automatically in the target group.
Renamed source topics are updated in the target group.
Existing topics can be copied once using Copy existing topic structure.
Before You Start
Make sure Topics is enabled in every target group. The bot must also have permission to create and rename topics there.
Enable Topic Sync
Open your forwarding task.
Open Forward Topics.
Turn on Auto-sync topics.
Tap Save.
Auto-sync starts after the task is saved.
Copy Existing Topics
Auto-sync handles new changes. To copy topics that already exist:
Tap Copy existing topic structure.
Select the source group or groups.
Select the target group or groups.
Confirm the copy request.
Save the task if you are creating a new task.
The copy runs in the background. You may see these statuses:
Queued: waiting for the bot to start.
Processing: the bot is copying topics.
Completed: all topics were processed successfully.
Partial: some topics were copied, but some failed.
Failed: the copy could not be completed. Check the target group permissions and try again.
The summary shows how many topics were created, already existed, or failed. Existing target topics with the same name are reused.
Manual Mapping
You can use Manual topic mapping together with Topic Sync. Manual mapping is useful when a source topic should be forwarded to a specific target topic or when you want to adjust individual mappings.
Important Notes
Copying only includes topics that exist when you start the copy.
Turn on Auto-sync topics to keep future topics and renames synchronized.
Topic deletion is not synchronized. Deleting a source topic does not delete the target topic.
If the copy stays queued for a while, keep the task saved and check again later. The bot processes it in the background.
Selecting topics does not save the task by itself. Always tap Save on the setup screen.
Last updated