Detection Settings

Configure how BeefyGuard detects impersonators and scammers in your group.

Access Detection Settings

Open dashboard (use /dashboard command)
Click on "Detection" tab
All detection settings are organized in cards

Core Detection Settings

Check on Join

What it does: Checks new members immediately when they join the group
Default: Enabled
When to use: Enable for immediate protection
Access: Dashboard → Detection tab → "Check on Join" toggle

Check on Name Change

What it does: Monitors when users change their name to match admins
Default: Enabled
When to use: Enable to catch impersonators who change names after joining
Access: Dashboard → Detection tab → "Check on Name Change" toggle

Check on Username Change

What it does: Monitors when users change their username to match admins
Default: Enabled
When to use: Enable for comprehensive username monitoring
Access: Dashboard → Detection tab → "Check on Username Change" toggle

Similarity Settings

Similarity Threshold

What it does: Sets how similar a name must be to trigger detection (0.0-1.0)
Default: 0.85
Range: 0.0 (exact match) to 1.0 (very loose match)
Recommendations:

0.90-1.0: Very strict (fewer false positives, may miss some)
0.85: Balanced (recommended)
0.70-0.84: More sensitive (catches more, may have false positives)

Access: Dashboard → Detection tab → "Similarity Threshold" input

Action Settings

Auto Ban on Match

What it does: Automatically ban users when impersonation is detected
Default: Enabled
When to use: Enable for automatic protection
Access: Dashboard → Detection tab → "Auto Ban on Match" toggle

Auto Kick on Match

What it does: Automatically kick (remove) users when detected
Default: Disabled
When to use: Use instead of ban if you want users to be able to rejoin
Access: Dashboard → Detection tab → "Auto Kick on Match" toggle

Warn on Match

What it does: Send a warning message when impersonation is detected
Default: Enabled
When to use: Enable to notify admins of detections
Access: Dashboard → Detection tab → "Warn on Match" toggle

Scanning Settings

Scan Interval (Minutes)

What it does: How often the bot scans all group members (in minutes)
Default: 30 minutes
Range: 0 (disabled) to 1440 (24 hours)
Recommendations:

Small groups (<100): 60 minutes
Medium groups (100-500): 30 minutes
Large groups (>500): 15-30 minutes

Access: Dashboard → Detection tab → "Scan Interval" input

Scan on Join

What it does: Scan new members when they join
Default: Enabled
When to use: Enable for immediate scanning of new members
Access: Dashboard → Detection tab → "Scan on Join" toggle

Recent Joiners Count

What it does: Number of recent joiners to scan
Default: 50
Range: 1-200
When to use: Increase for larger groups with many new members
Access: Dashboard → Detection tab → "Recent Joiners Count" input

SpamGuard Settings

The SpamGuard tab contains all spam detection features. Access via Dashboard → SpamGuard tab.

Cross-Chat Quote Spam

What it does: Detects when users quote messages from external scam channels using Telegram's "Reply in another chat" feature
Default: Disabled
Settings:

Enable/disable toggle
Action (delete, warn, restrict, kick, ban)
Track channels toggle (remember spam channels)
Auto-ban threshold (ban after X detections of same channel)

Access: Dashboard → SpamGuard tab → "Cross-Chat Quote Spam" card

Linked Channel Reply + Spam Link

What it does: Detects spam links hidden in replies to your group's linked channel
Default: Disabled
Settings:

Enable/disable toggle
Action (delete, warn, restrict, kick, ban)
Low-activity only toggle (only check users with few messages)
Message threshold (users with less than X messages)
Whitelist linked channel toggle

Access: Dashboard → SpamGuard tab → "Linked Channel Reply + Spam Link" card

Link Spam Detection

What it does: Detects links from low-activity users
Default: Disabled
Settings:

Enable/disable toggle
Action (delete, warn, restrict, ban)
Restrict duration (minutes to mute if action=restrict)
Link whitelist (trusted domains, comma-separated)

Access: Dashboard → SpamGuard tab → "Link Spam" card

First Message Link Ban

What it does: Instantly bans users posting links as their very first message
Default: Disabled
Settings:

Enable/disable toggle
Grace period hours (1-168, users joined longer than this are exempt)

Access: Dashboard → SpamGuard tab → "First Message Link Ban" card

Forward Spam Detection

What it does: Detects forwarded messages from low-activity users
Default: Disabled
Settings:

Enable/disable toggle
Action (delete, warn, restrict, ban)
Filter by source (all, channels only, bots only, groups only)

Access: Dashboard → SpamGuard tab → "Forward Spam" card

Reply-to-Forward Spam

What it does: Detects when users reply to forwarded spam messages
Default: Disabled
Settings:

Enable/disable toggle
Action (delete, warn, restrict, ban)

Access: Dashboard → SpamGuard tab → "Reply-to-Forward Spam" card

Fake Support Scam (Reply-to-User)

What it does: Detects when low-activity users reply to regular members (fake support scam)
Default: Disabled
Settings:

Enable/disable toggle
Action (delete, warn, restrict, kick, ban)
Max attempts before ban
Time window (minutes)

Access: Dashboard → SpamGuard tab → "Reply-to-User Spam" card

Message Threshold

What it does: Users with less than this many messages are considered "low-activity"
Default: 10
Range: 0-1000
Access: Dashboard → SpamGuard tab → Global settings

Time Window (Hours)

What it does: Users who joined within this many hours are also considered "new"
Default: 24
Range: 0-720
Access: Dashboard → SpamGuard tab → Global settings

Advanced Settings

Log Channel ID

What it does: Channel where bot sends all detection logs
Default: None
How to set:

Create a Telegram channel or group
Add bot as admin to channel
Get channel ID (use /groupinfo in channel)
Paste channel ID here

Access: Dashboard → Detection tab → "Log Channel ID" input

Log Topic ID (Forum Mode)

What it does: Specific forum topic for this group's logs
Default: None
How to set:

Enable Forum Mode in your log channel (must be a group)
Click "Auto-Create Topic" button in dashboard, OR
Manually enter topic ID

Access: Dashboard → Detection tab → "Log Topic ID" input

Flagged Names

What it does: List of names that should always trigger alerts
Default: Empty
How to add:

Via command: /add_flagged <name>
Via dashboard: Add in "Flagged Names" section

Access: Dashboard → Detection tab → "Flagged Names" list

Monitoring Settings

Monitor Recent Joiners

What it does: Continuously monitor recently joined members
Default: Enabled
When to use: Enable for active monitoring of new members
Access: Dashboard → Detection tab → "Monitor Recent Joiners" toggle

Monitor Check Interval

What it does: How often to check recent joiners (in minutes)
Default: 15 minutes
Range: 1-1440 minutes
Access: Dashboard → Detection tab → "Monitor Check Interval" input

Best Practices

Start with Defaults: Use default settings first, then adjust based on results
Monitor Logs: Set up log channel to see all detections
Adjust Threshold: Fine-tune similarity threshold based on false positives
Regular Scans: Set scan interval based on group size and activity
Flag Known Scammers: Add known scammer names to flagged list

Troubleshooting

Too Many False Positives

Increase similarity threshold (e.g., 0.85 → 0.90)
Add legitimate users to whitelist
Review flagged names list

Missing Detections

Decrease similarity threshold (e.g., 0.85 → 0.80)
Add more flagged names
Verify admin list is synced
Check scan interval isn't too long

Performance Issues

Increase scan interval
Reduce recent joiners count
Disable unnecessary monitoring features