Blocked-user lists delete messages from listed Telegram users.
Where to Configure
Dashboard path:
/blocked_user_lists
Visible navigation label: Blocked users.
What Blocked Users Do
When a message is sent by a user whose Telegram user ID or username is in an active blocked-user list assigned to the group, GramGroupsBot attempts to delete the message.
Blocked users are checked first, before stop words, links, required words, and rate limits.
Fields
A blocked-user list has:
- List title, max 100 characters.
- Blocked users list, entered as free text.
Each entry becomes a blocked_user item.
Supported Entry Formats
Use one Telegram user ID or username per entry.
Supported formats:
123456789
@username
username
The UI also accepts values separated by commas, semicolons, tabs, or new lines.
Username Normalization
Usernames are normalized to lowercase with an @ prefix.
Example:
UserName
@username
USERNAME
All become:
@username
User ID Matching
Numeric entries match Telegram user IDs.
Example:
123456789
This is more reliable than username matching because Telegram usernames can change.
Runtime Behavior
Runtime matching checks:
- Telegram sender ID.
- Telegram sender username, normalized to lowercase with
@.
If either matches, the message is deleted.
Assignment Behavior
Blocked-user lists are reusable and must be assigned to groups before they apply.
Assignments are managed on the Groups page and rule assignment workflows.
Example List
123456789
@known_spammer
987654321
fake_support
Important Limitation
A blocked user is not automatically banned or muted by this rule type. Current behavior is delete-message only.
To ban or mute a user across groups, use Mass actions.