Spam Filter Bot Admin Guide

This bot quietly removes spam messages based on rules added by group admins.

The bot does not ban, kick, mute, warn, restrict, or punish users. It only deletes messages that match the spam blocklist.


Who Can Use It?

Only Telegram group admins can use the bot commands.

Regular users who try commands are silently ignored.


Main Commands

The bot has three main commands:

1
2
3
/add
/list
/remove

1. Add Spam Rules

Use /add to add something to the spam blocklist.


Add a Keyword

Use this for recurring spam words, phrases, links, usernames, services, or calls to action.

Examples:

/add onlyfans
/add crypto investment
/add message me on telegram

Keyword rules are flexible. The bot also tries to catch simple obfuscation, such as spaces, dots, dashes, and common symbol swaps.

For example, a rule like:

/add onlyfans

may also catch:

1
2
3
4
only fans
0nly f@ns
o.n.l.y.f.a.n.s
only-fans

Add an Exact Rule

Use this when you only want to block a very specific message.

/add exact this is the exact spam message

Exact rules are safer than broad keyword rules, but they may miss spam if the spammer changes the wording.


Add a Phrase Rule

Use this for longer spam messages where the spammer may change a few words.

/add phrase message me on telegram for guaranteed crypto investment profits today

Phrase rules are conservative. They only match when enough distinctive words overlap. They are designed to avoid catching normal users by accident.


Add a Regex Rule

Regex is advanced. Use only when you know exactly what pattern you want.

/add regex t[.\s_-]*e[.\s_-]*l[.\s_-]*e[.\s_-]*g[.\s_-]*r[.\s_-]*a[.\s_-]*m

Regex can be powerful, but it can also create false positives if written too broadly.


2. Quick Add by Replying to Spam

The easiest workflow is:

  1. Find a spam message.
  2. Reply to that spam message with:
/add

The bot will add the replied-to message or caption to the spam list.

If configured, the bot will also delete:

  • the spam message you replied to
  • your /add command message

This keeps the group clean.

Example:

1
2
3
4
5
Spam message:
Message me on Telegram for guaranteed crypto investment profits

Admin replies:
/add

The bot adds that spam message to the blocklist.

Depending on configuration, reply-added messages may be stored as a conservative phrase rule so minor wording changes can still be caught without being overly broad.


3. List Current Rules

Use:

/list

Example output:

1
2
3
4
Blacklist rules:
#1 keyword: onlyfans
#2 phrase: message me on telegram for guaranteed crypto...
#3 exact: this is the exact spam sentence

Each rule has a number like #1, #2, or #3.

Use that number when removing a rule.


Search the List

Use /list <search> to find matching rules.

Examples:

/list crypto
/list telegram

This helps find rules when the list gets long.


4. Remove Rules

Remove by ID

This is the safest method.

/remove 3

That removes rule #3.

The bot may preserve old rule numbers for audit history, so numbers may not reset back to #1 after removing rules. That is normal.


If you do not remember the rule number:

/remove onlifanz

The bot will suggest close matches and tell you which ID to remove.

It should not remove fuzzy matches automatically. This prevents deleting the wrong rule by mistake.

Example:

/remove onlifanz

Bot may respond:

1
2
3
Possible matches:
#4 keyword: onlyfans - similarity 0.88
Run /remove ID to confirm.

Then run:

/remove 4

Recommended Admin Workflow

For Obvious Repeated Keywords

Use:

/add spamword

Examples:

1
2
3
4
/add onlyfans
/add crypto investment
/add message me
/add telegram me

For Full Spam Messages

Reply directly to the spam message with:

/add

This is the quickest and cleanest method.


For Risky or Common Words

Be careful with broad terms.

Avoid adding overly generic single words like:

1
2
3
4
5
6
/add help
/add message
/add money
/add garden
/add seed
/add food

These may catch real users.

Prefer more specific phrases:

1
2
3
4
/add guaranteed crypto profits
/add message me on telegram
/add investment opportunity
/add private signal group

What the Bot Tries to Catch

The bot can catch simple spam obfuscation for normal keyword rules.

Examples:

1
2
3
4
5
onlyfans
only fans
0nly f@ns
o.n.l.y.f.a.n.s
only-fans
1
2
3
4
5
telegram
t e l e g r a m
te1egram
t.e.l.e.g.r.a.m
telegram-me

It does not use AI or semantic guessing. This is intentional to reduce false positives.


Safety Notes

The bot is designed to prefer missing some spam over deleting real users’ messages.

Use broad rules carefully.

Good rules:

1
2
3
4
5
/add onlyfans
/add message me on telegram
/add guaranteed crypto profits
/add investment signal group
/add free crypto airdrop

Riskier rules:

1
2
3
4
5
/add money
/add help
/add message
/add telegram
/add investment

Those may be valid conversation topics, depending on the group.

When in doubt, use a longer phrase or reply to the spam with /add.


Troubleshooting

I used /add, but nothing happened

Possible causes:

  • You are not a Telegram admin in the group.
  • The bot is not running.
  • The bot is not allowed in this chat.
  • The bot is missing permissions.
  • The command was typed in the wrong group.

The bot adds rules but does not delete messages

The bot needs admin permission:

Delete messages

It does not need ban, kick, mute, invite, pin, or admin-management permissions.


/list works, but spam is not being deleted

Possible causes:

  • The bot is still in dry-run mode.
  • The spam message does not match any rule.
  • The bot lacks Delete messages permission.
  • The rule is too exact and the spammer changed wording.

Rule numbers skip

This is normal.

If rule #1 is removed, the next new rule may be #2, not #1.

Old IDs are preserved for audit history.


Quick Command Cheat Sheet

/add onlyfans

Add a keyword rule.

/add exact full spam message here

Add an exact-message rule.

/add phrase longer spam sentence here

Add a conservative phrase rule.

/add regex pattern_here

Add an advanced regex rule.

Reply to spam with:
/add

Quickly add the replied-to spam message.

/list

Show active rules.

/list crypto

Search active rules.

/remove 4

Remove rule #4.

/remove onlifanz

Find close matching rules before removing.

Edit

Pub: 24 May 2026 19:59 UTC

Views: 6