1# Replies and Topics
2 
3`message.reply_to_message` is not enough for production reply logic.
4 
5## Valid reply semantics
6 
7In forum-enabled chats, replying to the topic starter is often not a meaningful reply target for command logic.
8 
9A practical rule:
10- if there is no `reply_to_message`, it is not a reply
11- outside forum topics, any reply is valid
12- inside forum topics, ignore replies where `reply_to_message.message_id == message.message_thread_id`
13 
14Use `scripts/topic_aware_reply_helpers.py`.
15 
16## Thread id normalization
17 
18`message_thread_id` needs normalization because Telegram uses it in several different ways:
19- real forum topics
20- private-message topics
21- linked discussion groups for channel comments
22- pseudo-thread ids in non-forum chats when replying to a bot
23 
24Useful rules:
25- in forum chats, only return `message_thread_id` for real topic messages
26- in linked discussion groups, keep `message_thread_id` only when it represents a real discussion thread
27- ignore pseudo-thread ids created by bot replies in plain chats
28- when needed, prefer the current message thread and fallback to the replied message thread
29 
30## Reply filters
31 
32For routers, keep reusable reply filter expressions rather than repeating raw `F.reply_to_message` checks everywhere.
33 
34Two useful variants:
35- `IS_REPLY`: true only for meaningful replies
36- `FILTER_REPLY_OR_NONE`: allow no reply or a topic-root reply, but exclude arbitrary reply-to-user cases
37