Skip to main content

๐Ÿค User Whitelist

The User Whitelist allows you to exempt specific users from Fren One's moderation rules. Whitelisted users can post without restrictions - they won't be warned, muted, kicked, or banned by the bot's moderation filters.

Overviewโ€‹

This feature is particularly useful for trusted community members, team members, ambassadors, or partners who require flexibility in the chat. When a user is whitelisted, all moderation filters are bypassed for their messages.

Configurationโ€‹

In the webappโ€‹

Open your workspace, select the Telegram group under Channels in the sidebar, then select Moderation, then the Whitelists tab. Each addition and removal saves immediately; removing an entry asks for confirmation.

The Whitelists tab has three separate lists:

ListWhat it does
Member WhitelistMembers here bypass every moderation check on messages they send. Added by Telegram username.
Domain ExceptionsLinks pointing to these domains skip link moderation checks.
Mention ExceptionsMessages that mention these usernames skip link and mention moderation.

In Telegram (bot menu)โ€‹

To access the User Whitelist:

  1. Use the /settings command in your chat
  2. Navigate to ๐Ÿ›ก๏ธ Moderation โ†’ ๐Ÿค User Whitelist
  3. Use the available options to manage your whitelist

Adding Users to the Whitelistโ€‹

Follow these steps to whitelist users:

  1. Click Add User
  2. Enter the user's Telegram username (e.g., @username) or their Telegram ID
  3. Type in usernames in the chat. Press Enter to validate
Adding Multiple Users

To add multiple users at once, separate their usernames or IDs with commas.

Example: @user1, @user2, 123456789 or user1, user2, 123456789

Once added, the selected users are now fully exempt from all Fren One moderation actions.

Removing Users from the Whitelistโ€‹

Follow these steps to remove users from the whitelist:

  1. Click Remove User
  2. Enter the user's Telegram username (e.g., @username) or Telegram ID
  3. Press Enter to validate
Removing Multiple Users

To remove multiple users at once, separate their usernames or IDs with commas.

Example: @user1, @user2, 123456789 or user1, user2, 123456789

Once removed, the selected users are now subject to normal moderation rules.

Common Use Casesโ€‹

Team Membersโ€‹

Whitelist your:

  • Community managers
  • Moderators
  • Support staff

Why: They need to share links, images, and content without triggering filters.

Partners & Ambassadorsโ€‹

Whitelist:

  • Official project partners
  • Brand ambassadors
  • Verified collaborators
  • Guest speakers or AMA hosts

Why: They often need to share promotional content or external links.

Bots & Automationโ€‹

Whitelist:

  • Utility bots (e.g., price feeds, announcements)
  • Custom automation accounts
  • Integration services

Why: Bot messages may trigger spam or link filters.

Troubleshooting

Whitelisted user still getting moderated?

  • Verify the username or ID was entered correctly
  • Check if the user was successfully added (no typos or extra spaces)
  • Ensure the bot has proper admin privileges
  • Try removing and re-adding the user

Cannot add a user to the whitelist?

  • For IDs, ensure you're using numeric Telegram IDs
  • Check for proper comma separation when adding multiple users
  • Make sure the bot has admin permissions

Need to find a user's Telegram ID?

  • Use the user's username if available (easier)
  • Forward a message from the user to a bot like @userinfobot
  • Check with other Telegram ID lookup tools