Skip to main content

👿 Spam Detection

Automatically detect spam sent by new users. This feature uses Fren One's custom AI model to identify spammy or scam-like messages and either removes them instantly or applies configured moderation actions, ensuring your chat remains free from unwanted distractions.

Where to configure it

In the webapp: Open your workspace, select the Telegram group under Channels in the sidebar, then select AI Features, then the AI Moderator tab. Spam detection is the Fast spam filter rule (Built-in) under Messages. Its switch saves instantly; open the rule for its full settings, which save with the Save bar in that dialog.

In Telegram (bot menu): the /settings menu route below still works.

Overview​

Spam Detection runs on a spam model hosted by Fren One and trained on Telegram spam, rather than a general-purpose AI model.

How It Works​

The model screens each member's first message in the group as it arrives, looking for signs such as:

  • External group mentions: Tagging multiple users to get attention
  • Excessive links or emojis: Overuse of promotional links or emoji spam
  • Scam keywords and context: Terms like "airdrops," "giveaways," "send me your wallet," "guaranteed profit"
  • Suspicious forwarding patterns: Mass-forwarded messages from other groups
  • Unusual message structures: Patterns often associated with bots and automated spam
First messages only

Spam Detection only ever classifies a member's first message in the group, whatever your chat's new-member definition says. That definition still drives filters and captcha, but not this detector. Established members are never screened by it.

Configuration in Telegram (bot menu)​

To access Spam Detection settings:

  1. Use the /settings command in your chat
  2. Navigate to 🤖 AI → 👿 Spam Detection
  3. Use the toggle to turn the feature 🟢 ON or 🔴 OFF

Spam Detection Settings​

Enabled/Disabled Toggle​

Toggle AI-powered spam detection for this group.

  • 🟢 Enabled: Spam detection is active for new users
  • 🔴 Disabled: Spam detection is paused
Immediate Protection

Enable this feature as soon as you add Fren One to your community for instant protection against spam bots and scammers targeting new member slots.

Actions​

The action(s) to be taken when a user's message is detected as spam.

You can combine multiple actions for comprehensive spam response:

Available actions:

  • Mute: Temporarily restrict the user from sending messages
  • Kick: Remove the user from the group (can rejoin later)
  • Ban: Permanently remove the user from the group
  • Delete message: Remove the spam message from the chat

Multiple Action Combinations​

Select multiple actions to create layered responses:

Example combinations:

  • Delete message + Mute: Remove spam and timeout the user
  • Delete message + Kick: Remove spam and remove user (temporary)
  • Delete message + Ban: Remove spam and permanently ban spammer
  • Mute only: Keep message visible for review but silence the user
  • Delete message + Mute + Ban: Maximum protection (remove message, restrict, then ban)
Recommended Configuration

For most communities, Delete message + Mute or Delete message + Ban provides the best balance between protection and preventing false positives from affecting legitimate users.

Duration (for Mute action)​

If Mute is selected, specify the duration of the restriction.

Common durations:

  • 1 minute: Brief timeout (warning)
  • 5 minutes: Short restriction
  • 1 hour: Standard spam timeout
  • 1 day: Extended restriction
  • 7 days: Week-long ban
  • Permanent: Indefinite mute (until manually unmuted)
Smart Duration Strategy

Start with shorter durations (1 hour) and increase for repeat offenders. Very short durations (1 minute) can serve as automated warnings.

Troubleshooting

Legitimate users being flagged?

  • Review what triggered the detection
  • Check if user truly meets "new user" criteria
  • Consider using Mute instead of Ban for first offenses
  • Add user to User Whitelist if trusted
  • Adjust "new user" definition in Filters

Spam getting through?

  • Verify Spam Detection is enabled (🟢)
  • Check bot has necessary permissions (delete, mute, ban)
  • Ensure spammers meet "new user" criteria
  • Combine with Filters for specific patterns
  • Use Captcha as additional protection
  • Report missed spam patterns (helps improve the model)

Too many false positives?

  • Switch from Ban to Mute as the action
  • Reduce duration of Mute (use 1-5 minutes)
  • Remove "Delete message" to allow admin review
  • Adjust "new user" definition to shorter timeframe
  • Enable veto-like features for community input

Actions not being applied?

  • Verify bot has admin privileges
  • Check bot has specific permissions needed (mute/kick/ban/delete)
  • Remember only a member's first message in the group is screened
  • Test with a clear spam-like message from new account

Want to review before action?

  • Use only Mute with very short duration (1 minute)
  • Don't enable Delete message
  • Check notifications for AI Spam events
  • Manually review and take further action

On this page