Rules reference.

Groups

A group is a connected Telegram chat plus assignment state for moderation rules. Rules affect a group only when the group is active, the rule is enabled, the rule is assigned, and the bot has required Telegram permissions.

Statuses and billing

• Statuses: active, paused, error, disconnected.
• Billing status: billable or non_billable.
• Billable condition: group must be active and billing status must be billable.

Assignment model

• One-per-group rule types: link filter, rate limits, welcome messages.
• List-based rule types: stop words, required words, blocked users.

Stop words

Stop words are reusable lists of blocked words and phrases. If a message text or caption matches an assigned active list, the bot attempts to delete the message.

Behavior

• Case-insensitive matching for words and phrases.
• Global default list Global stop words is created automatically and assigned by default.
• Separator-based obfuscation like s.p.a.m is detected by normalization.

Limits

• Delete-only action (no built-in ban or mute).
• No regex and no wildcard syntax.

Stop words guide — practical walkthrough with examples and common mistakes.

Using one stop word list across many Telegram groups — how shared stop words work at network level.

Required words

Required words enforce presence of at least one configured word or phrase. If none is found, the bot deletes the message.

Runtime order

• Checked after blocked users, stop words, and links.
• Replies are skipped by current runtime logic.
• Matching covers message text and captions.

Limits

• No regex or wildcard support.
• No warning-only mode before deletion.

Links

Link rules delete messages with links according to selected mode and configured domain lists.

Modes

• Block all links (block_all).
• Block listed domains (block_listed).
• Allow only approved domains (allow_approved).

Scope and flags

• One active link rule per group.
• Telegram-specific toggles: delete invite links and delete public Telegram links.
• No wildcard domain syntax (for example *.example.com).

Telegram link filter guide — block-all, blocklists, approved domains, and invite link rules explained.

Rate limits

Rate limits cap how many messages one user can send inside a time window in each group. Messages above the limit are deleted.

Rule model

• Parameters: max_messages and window_seconds.
• One active rate-limit rule per group.
• Checked last in the moderation chain.

Runtime details

• Counters are in memory and reset on runtime restart.
• Default create form values: 5 messages / 60 seconds.

Welcome messages

Welcome messages send a template when a new member joins a connected group.

Template behavior

• One active welcome template per group.
• Supported placeholder: {first_name} with fallback when first name is missing.
• The bot's own join event is ignored.

Limits

• No rich templating beyond {first_name}.
• No buttons or media attachments.

Mass actions

Mass actions run cross-group moderation commands across eligible active groups in the same account.

Supported commands

Current-group commands (run in one group):

• /ban — ban the replied user in this group.
• /mute — mute the replied user in this group for 24 hours.
• /unban — unban the replied user in this group.
• /unmute — remove mute for the replied user in this group.

Network-wide commands (run across all active groups):

• /banall — ban the replied user in all active groups.
• /muteall — mute the replied user in all active groups.
• /unbanall — unban the replied user in all active groups.
• /unmuteall — remove mute in all active groups.

Execution model

• Operationally reliable flow: reply to target user's message with the command.
• Network-wide commands run asynchronously and can finish with partial success.
• Groups can be skipped when bot permissions are missing or group is not active.
• Access requires owner, admin, or manager role in the account.

Blocked users

Blocked-user lists match Telegram user IDs or usernames and delete messages from matched senders in assigned groups.

Behavior

• Checked first in moderation order.
• Accepts numeric Telegram IDs and usernames.
• Works as list-based assignment, not as an automatic ban/mute action.

Limits

• No temporary duration inside this rule type.
• Use mass actions for immediate cross-group ban/mute.