Skip to main content

🖤 User Blacklist

The User Blacklists feature allows administrators to proactively prevent unwanted users, such as scammers or botted airdrop-hunters, from joining the community. By banning specific names, name patterns, enforcing username requirements, or limiting excessive emoji usage in Telegram names, this feature strengthens community security.

Overview​

When enabled, the Fren One bot will automatically monitor and prevent users who match blacklist criteria from joining your community. Additionally, if Fren One was not added from the launch of the community - admins can scan the chat to identify and remove existing users who violate the blacklist criteria.

Configuration​

In the webapp​

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

The Blacklist tab also checks members who join with a personal-profile channel. Turn on Check members who have personal channels, then either Disallow Personal Channels to block every member with one, whatever its title, or add Blocked Channel Title Patterns to block only channels whose title matches. Type a description and press Enter, or enter a regex directly. While all personal channels are blocked, title patterns aren't needed.

In Telegram (bot menu)​

To set up user blacklist:

  1. Use the /settings command in your chat
  2. Navigate to 👋 Onboarding → 🖤 User Blacklist
  3. Configure your blacklist settings

Banned Names​

Admins can maintain a list of usernames that are banned from joining the community.

To add or remove name patterns in Telegram, send /user_blacklist (or open 👋 Onboarding → 🖤 User Blacklist in /settings) and use the banned-names buttons. The same menu holds the full toggle list (username required, emoji limits, scan chat).

Use cases:

  • Blocking usernames that impersonate mods, team members, or trusted individuals
  • Preventing known scammers from joining
  • Blocking suspicious username patterns
Regular Expressions

You can use regular expressions to match a series of usernames, for example all usernames containing the word "admin".

🤖Regex Generator
Create regex for:

Username Required Toggle​

Scam accounts often avoid setting up usernames to bypass moderation bots.

Toggle this option Enabled to enhance community security. It enforces a rule requiring all new users to have a Telegram username to join the group.

Benefits:

  • Increases accountability
  • Makes it harder for scammers to hide
  • Easier to identify and track problematic users
  • Automatically, mass-created accounts often do not have usernames

Emoji Limit​

Bots and airdrop hunters often use excessive emojis in their usernames.

This feature limits the number of emojis allowed in a username.

Available options:

  • None (no limit)
  • 3 emojis
  • 5 emojis
  • 8 emojis
  • 10 emojis
tip

Setting a reasonable emoji limit (3-5) helps filter out bot accounts while still allowing legitimate users to express themselves.

Common Use Cases​

Preventing Impersonation​

Block usernames that mimic your team members or official accounts:

  • Add variations of admin/mod names to banned list
  • Use regex to catch similar patterns
  • Example regex: admin|moderator|support|official

Blocking Airdrop Hunters​

These accounts often have:

  • No username set
  • Excessive emojis in display names
  • Generic or bot-like patterns

Solution: Enable Username Required and set Emoji Limit to 3-5.

Cleaning Up Existing Groups​

If you're adding Fren One to an established group:

  1. Configure your blacklist settings
  2. Use Scan Chat to identify violators
  3. Review and remove flagged accounts
  4. Monitor new joins with automated enforcement

Admin Commands​

CommandDescription
/user_blacklistOpen the user blacklist menu in chat, including the banned-names list

There are no separate commands for adding or removing name patterns; manage them from the menu or the webapp. /blacklist and /unblacklist belong to the word blacklist, not this page.

Troubleshooting

Blacklist not working for new members?

  • Ensure the bot has admin privileges with ban permissions
  • Check that blacklist rules are properly configured
  • Verify the bot can read user information

Legitimate users being blocked?

  • Review your banned names list for overly broad patterns
  • Adjust emoji limits if too restrictive
  • Consider temporarily disabling Username Required if needed

On this page