Back to Blog
Deep divesNovember 19, 20262 min read

Filter forbidden words in a Telegram group

A word list sounds simple until someone writes the word with a zero instead of an o. How to set up a filter that catches that and still leaves normal chat alone.

Filter forbidden words in a Telegram group

A forbidden words filter checks each message in a Telegram group against a list of words and phrases and acts when one matches. In BotLaunch you add your words with a category such as profanity, scams or competitors, choose how each word is matched, and set its action: delete the message, warn, mute, kick or ban the sender. Admins can be exempt, and a test box shows what a message would trigger.

What the filter is for

Every group has words it does not want. For one it is swearing, for another it is the name of a scam token, for a shop community it might be a competitor's name. Telegram has no word filter of its own, so this job falls to a bot that reads group messages and removes the ones that break the rule.

Build the list with categories

In the forbidden words module every word or phrase you add gets a category: profanity, hate speech, insults, adult content, spam, scams, crypto scams, drugs, violence, competitors or custom. Categories keep a long list readable, and each word can carry a severity from low to critical so you can see at a glance which matches matter most.

Choose how each word is matched

The match mode decides what counts as a hit, and it is where most false alarms are prevented:

  • Whole word: matches the word on its own, so a short word does not fire inside a longer, innocent one. A good default.
  • Exact and contains for stricter or looser matching.
  • Pattern: wildcards for families of spellings.
  • Regular expression, for admins who know them.
  • Leetspeak: catches the word written with numbers or symbols in place of letters.

Pick the action

For each word you choose what happens when it appears. Delete removes the message. Warn hands the case to the warnings module, so repeat offenders reach your warning limit and its automatic action. Mute, kick and ban remove the message and deal with the sender. A new word starts with delete as its action, which is a safe default for most lists.

Test before it acts

Before switching the module on, paste a few real messages from your group into the test box on the module page. It shows which words would match. If an innocent message is caught, change that word's match mode to whole word or remove it. Settings for text normalisation and evasion detection catch extra spacing and symbol tricks.

Turn on the admin exemption so your team can quote a banned word when explaining a rule, and add a notification rule if you want to hear when a forbidden word is detected.

Frequently asked questions

Does Telegram have a built-in word filter?

No. Word filtering in a group is done by a bot with permission to delete messages.

Can the filter catch words written with numbers instead of letters?

Yes. The leetspeak match mode catches common replacements such as a zero for the letter o.

How do I test a word list before it deletes anything?

Paste sample messages into the test box on the module page. It shows which words would match.

Are admins affected?

Not if you turn on the admin exemption.

Share this article