How to assign moderation rules to Telegram groups

Creating a moderation rule does not make it active in Telegram automatically.

In GramGroupsBot, rules and lists are reusable account-level configuration. Create the configuration once, then assign it to the connected groups where it should work. This lets one account use different moderation settings for public communities, support chats, marketplaces, and other group types.

Before You Assign a Rule

Confirm these conditions first:

The Telegram group is connected to your account.
The group has active status.
The bot is still an administrator in the group.
The bot has the permission required for the intended action.
The rule or list already exists and is enabled.

For message-based moderation, the bot must be allowed to delete messages. A correctly configured rule cannot remove messages if Telegram has removed this permission. See Connect a Telegram group and Bot permissions if the group is not ready.

Rule Lists and Per-Group Rules

GramGroupsBot has two configuration models.

Configuration	Rule types	How it is used
Reusable lists	Stop words, Required words	Create a list once and select it for the groups that need it.
Per-group rules	Link filter, Rate limits, Welcome messages	Create a rule, then choose the required rule for each group.

A change to a selected list or rule affects the groups where it is assigned. For example, one stop-word list can protect several public groups, while a separate required-word list can enforce tags in a marketplace chat.

Assign a Rule to a Group

Use the Groups section for the actual assignment.

Create the required list or rule in its dashboard section.
Open Groups and select the target Telegram group.
In the group settings form, choose the required configuration.
Click Save changes.
Verify that the group is active and the bot has the required Telegram permissions.

The group settings form uses these labels:

Dashboard label — an internal name; it does not change the Telegram group title.
Stop words list
Required words list
Links list
Message limit
Greeting

To enable anti-spam moderation in a public community, create a list in Stop words, open the group, choose that list in Stop words list, and click Save changes. The same workflow applies to required words, link filters, rate limits, and welcome messages.

Blocked-user lists are created in Message delete lists. The runtime can apply an existing list and deletes messages from matching users; it does not automatically ban or mute them. The current Groups form, however, has no blocked-user-list selector, so that assignment cannot currently be created or changed through the public dashboard.

One Configuration of Each Type per Group

A group uses one active configuration of a given type at a time.

Selecting a new link rule replaces the previous link rule for that group.
Selecting a new rate limit replaces the previous rate limit.
Selecting a new welcome-message template replaces the previous greeting.
Selecting a different stop-word or required-word list replaces the current list of that type.

Do not expect two rate limits, two link rules, or two different lists of the same type to run together in one group.

Understand Assignment Status

Rule and list pages show where a configuration is used.

Not assigned means no current group uses the configuration.
All N groups means every relevant connected group uses it.
X of N groups means only part of the group network uses it.

Some dashboard screens show a numeric count together with wording such as Assigned to every group. These are assignment summaries only. They do not create a separate global-rule scope: every active rule still has concrete group assignments.

Current Limitation: Group Sets Do Not Assign Rules

A group set is a saved collection of groups, such as Public communities, Support groups, Regional chats, or Test groups. It stores a title, description, enabled state, and members. In the current dashboard it is not selectable in the assignment form, and the runtime does not use it to resolve moderation rules. Adding a group to a set does not enable, disable, or change any rule. Treat group sets as an organisational list only.

Why a Rule May Not Apply

Check	What to verify
Group status	The group is `active`, not paused, disconnected, or in an error state.
Assignment	The intended list or rule is selected for this group.
Enabled state	The list or rule itself is enabled.
Bot permissions	The bot can delete messages when the rule requires deletion.
Match condition	The sent message actually matches the configured word, link, user, or rate-limit condition.
Runtime update	A saved change can take a short time to reach the moderation runtime.

Do not rely on a fixed cache-refresh time. If the rule still does not apply after a short wait, recheck the assignment and permissions before changing the configuration again.

For deeper diagnostics, see Troubleshooting.

Assign rules to groups