Skip to main content

🔍 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​

By configuring a list of prohibited words, the bot will automatically detect and delete any messages containing those terms. This proactive approach helps prevent spam, scams, inappropriate language, and other unwanted content from appearing in your community.

Configuration​

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​

Displays the current list of words that are blacklisted.

Use this to:

  • Review your current blacklist
  • Check if a word is already blacklisted

Add Word(s)​

Allows admins to add new words to the blacklist.

Prompt: "📝 Please write the words or phrases, separated by commas (,) if adding multiple blacklist words/phrases.

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

Example input:

scam, rug pull, airdrop
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.

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

Example regex patterns:

scam.*
.*airdrop.*
(buy|sell).*now
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

Prompt: "📝 Please write the word(s) to remove, separated by commas (,) for multiple words."

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
  4. Optional action can be taken against the user (depending on integration with other features)
Instant Deletion

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

Common Use Cases​

Preventing Scam Keywords​

Scenario: Block common scam terminology.

Blacklisted words:

  • scam, rug pull, honeypot
  • free money, guaranteed profit
  • send BTC, send ETH
  • admin will never DM

Result: Scam attempts are automatically removed.

Blocking Inappropriate Language​

Scenario: Maintain a professional or family-friendly environment.

Blacklisted words:

  • Common profanity
  • Offensive slurs
  • Inappropriate terms
  • NSFW content references

Result: Clean, appropriate conversations.

Preventing Spam​

Scenario: Block repetitive spam phrases.

Blacklisted phrases:

  • click here now
  • limited time offer
  • buy now
  • act fast

Result: Reduced spam and promotional content.

Competitor Mentions​

Scenario: Prevent promotion of competing projects.

Blacklisted words:

  • Competitor project names
  • Competing token symbols
  • Alternative platform names

Result: Focus stays on your community's project.

Preventing Airdrop Hunters​

Scenario: Reduce low-quality engagement.

Blacklisted words:

  • airdrop, free tokens
  • when airdrop, airdrop date
  • free money, giveaway

Result: More genuine community engagement.

Best Practices​

Effective Word Blacklist Management
  • Start with obvious problematic words
  • Add words gradually based on observed issues
  • Use regex for catching variations (e.g., sc@m, sc4m)
  • Review and update the list regularly
  • Test patterns to avoid false positives
  • Document why each word is blacklisted (internally)
  • Consider cultural and linguistic variations
  • Balance between protection and over-moderation
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

Advanced Blacklist Strategies​

Pattern-Based Filtering​

Use regex to catch sophisticated attempts to bypass filters:

Leetspeak and Character Substitution:

sc[a@4]m
[a@]irdrop
fr[e3]{2}

Catches: scam, sc@m, sc4m, airdrop, @irdrop, free, fr33

URL Patterns:

(http|https):\/\/.*
bit\.ly\/.*
t\.me\/.*

Catches: URLs and common short links

Cryptocurrency Addresses:

0x[a-fA-F0-9]{40}
bc1[a-zA-Z0-9]{39,59}

Catches: Ethereum and Bitcoin addresses

Context-Specific Blacklists​

Create different blacklist categories:

Financial Scams:

  • Investment promises
  • Send/receive money keywords
  • "Guaranteed" returns language

Social Engineering:

  • Impersonation terms
  • Urgency language ("act now", "limited time")
  • Authority claims ("official", "verified")

Spam:

  • Promotional language
  • Excessive emoji patterns
  • Repetitive phrases

Integration with Other Features​

Combine Word Blacklist with:

Triggers:

  • Word blacklist for deletion
  • Trigger for warning message
  • Escalation to warn/kick/ban

Filters:

  • Blacklist specific words
  • Filter links containing those words
  • Apply to new users only

Warns:

  • First blacklisted word → Auto-warn
  • Multiple violations → Escalate action
  • Track repeat offenders

User Whitelist:

  • Allow trusted users to use blacklisted terms
  • Moderators discussing moderation
  • Educational contexts

Regular Expression Examples​

Basic Patterns​

Exact match:

^scam$

Only matches "scam" as a complete word

Contains:

.*scam.*

Matches any message containing "scam"

Starts with:

^buy.*

Matches messages starting with "buy"

Ends with:

.*now!$

Matches messages ending with "now!"

Advanced Patterns​

Case-insensitive matching:

(?i)scam

Matches: SCAM, Scam, scam, ScAm

Multiple variations:

(scam|fraud|ponzi|rug.*pull)

Matches any of these terms

Character variations:

sc[a@4][mn]

Matches: scam, sc@m, sc4m, scan, sc@n, sc4n

Phone numbers:

\+?[0-9]{1,3}[-.\s]?[0-9]{3,4}[-.\s]?[0-9]{4}

Matches various phone number formats

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
  • Consider more specific phrases instead of single words
  • 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 first
  • Ensure proper escaping of special characters
  • Verify the regex syntax is correct
  • Start simple and gradually add complexity

Too many words to manage?

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

Maintenance and Updates​

Regular Review Schedule​

Weekly:

  • Check for new spam patterns
  • Review recent deletions for false positives
  • Update based on community feedback

Monthly:

  • Full blacklist audit
  • Remove obsolete terms
  • Optimize regex patterns
  • Document changes

Quarterly:

  • Evaluate overall effectiveness
  • Compare with similar communities
  • Update strategy based on results
  • Train moderators on new patterns

Community Feedback​

  • Create a channel for users to report false positives
  • Document legitimate use cases that were blocked
  • Adjust blacklist based on community needs
  • Maintain transparency about moderation rules
tip

Remember to give the Fren One bot admin privileges with delete permissions in your chat for the Word Blacklist feature to work properly. The bot needs permission to delete messages containing blacklisted words.