🔤 Word Blacklist

The Word Blacklist feature allows moderators and community leads to automatically remove messages containing specific blacklisted words. This feature helps maintain the quality of conversations and ensures that inappropriate or unwanted terms are not used in the group.

Overview

The agent deletes any message containing a blacklisted word or pattern.

Configuration

In the webapp

Open your workspace, select the Telegram group under Channels in the sidebar, then select Moderation, then the Word Blacklist tab. Changes save with the Save bar at the bottom of the page.

In Telegram (bot menu)

To access Word Blacklist settings:

1. Use the /settings command in your chat
2. Navigate to 🛡️ Moderation → 🔤 Word Blacklist
3. Manage your blacklisted words using the available options

Managing Word Blacklist Settings

View Blacklisted Words

The current list of words that are blacklisted is displayed in the 🔤 Word Blacklist menu.

Add Word(s)

Allows admins to add new words to the blacklist.

Regular expressions must be prefaced with r:, e.g., r: .admin."

Multiple Words at Once

Separate multiple words or phrases with commas to add them all in one go. This saves time when setting up your blacklist.

Example input:

scam, rug pull, airdrop

Regular Expressions Support

You can also use regular expressions here to catch words that are:

• Parts of sentences
• Begin with specific words
• Match specific patterns
• Include variations and misspellings

🤖Regex Generator

Create regex for:

Advanced Pattern Matching

Regular expressions allow you to create powerful filters that catch variations of words and complex patterns. Learn more about regex syntax online before implementing complex patterns.

Remove Word(s)

Removes words from the blacklist.

When to use:

• Word is no longer problematic
• False positives are occurring
• Community standards have changed
• Temporary restrictions are lifted

How Word Blacklist Works

1. User sends a message containing a blacklisted word or pattern
2. Bot detects the match against the blacklist
3. Message is automatically deleted from the chat

Instant Deletion

Messages containing blacklisted words are deleted immediately. Ensure your blacklist is accurate to avoid removing legitimate messages.

Admin Commands

Command	Description
/blacklist [word/pattern]	Add a word or pattern to the blacklist
/unblacklist [word/pattern]	Remove a word or pattern from the blacklist

tip

You can manage blacklist entries directly in chat without opening the settings menu. Regular expressions are supported: prefix with r: (e.g., r:.*scam.*).

Avoiding False Positives

• Be careful with common words that might appear in legitimate contexts
• Test blacklist patterns before deploying
• Use specific phrases rather than single common words
• Monitor for legitimate messages being deleted
• Provide alternative ways for users to discuss necessary topics
• Consider whitelisting trusted users who need to discuss blacklisted terms
• Use partial matching carefully to avoid catching unintended words

Troubleshooting

Blacklist not working?

• Verify the Word Blacklist feature is enabled
• Check if bot has permission to delete messages
• Ensure bot has admin privileges
• Test with a known blacklisted word

Legitimate messages being deleted?

• Review your blacklist for overly broad terms
• Check regex patterns for unintended matches
• Add exceptions for trusted users via User Whitelist

Users bypassing blacklist?

• Add common character substitutions to your patterns
• Use regex to catch variations
• Monitor for new bypass methods
• Update blacklist regularly

Regex not working as expected?

• Test regex patterns in an online regex tester
• Ensure proper escaping of special characters
• Verify the regex syntax is correct
• Start simple and gradually add complexity

Too many words to manage?

• Focus on highest-impact words first
• Use regex patterns to consolidate similar terms
• Regular review and cleanup of outdated entries