🔍

First Steps After Setup

What to do after you've completed the initial BeefyGuard setup.

1. Verify Bot is Working

Test Basic Functionality

  1. Check Bot Status:

    /botinfo

    Verify bot has all required permissions.

  2. Get Group Info:

    /groupinfo

    Save your Group ID for dashboard access.

  3. Test Detection:

    • Have a test user change their name to match an admin
    • Bot should detect and take action (if auto-ban is enabled)

2. Configure Detection Settings

Essential Settings

  1. Access Dashboard:

    • Use /dashboard command
    • Click the provided link

  2. Go to Detection Tab:

    • Enable "Check on Join"
    • Enable "Check on Name Change"
    • Set Similarity Threshold (default: 0.85)
    • Enable "Auto Ban on Match"

  3. Set Scan Interval:

    • Default: 30 minutes
    • Adjust based on your group size
    • Smaller groups: 60 minutes
    • Larger groups: 15-30 minutes

3. Sync Admin List

Track Your Admins

  1. Automatic Sync:

    /sync_admins

    This automatically tracks all current group admins.

  2. Manual Add (if needed):

    /add_admin Admin Name

  3. Verify:

    /list_admins

    Should show all tracked admins.

4. Set Up Log Channel (Recommended)

Why Use a Log Channel?

  • See all bot activity in one place
  • Monitor detections and actions
  • Debug issues easily

Setup Steps

  1. Create a Telegram channel
  2. Add @beefyguard_bot as admin
  3. Get channel ID:
    • Add bot to channel
    • Use /groupinfo in channel
    • Copy the channel ID (starts with -100)
  4. Set in dashboard:
    • Go to Detection tab
    • Find "Log Channel ID"
    • Paste channel ID
    • Save

5. Add Flagged Names (Optional)

When to Use

  • Known scammer names
  • Names that should always trigger alerts
  • Common impersonation patterns

How to Add

  1. Via Command:

    /add_flagged Scammer Name

  2. Via Dashboard:

    • Go to Detection tab
    • Find "Flagged Names" section
    • Add names manually

  3. View All:

    /show_flagged

6. Configure Announcements (If Needed)

If You Have an Announcement Channel

  1. Add bot to announcement channel as admin
  2. In dashboard, go to Announcements tab
  3. Set "Announcement Channel ID"
  4. Enable "Announcement Forwarding"
  5. Optionally enable "Auto Pin Announcements"

7. Test Everything

Comprehensive Test

  1. Test Detection:

    • Create test user with admin-like name
    • Should be detected and banned

  2. Test Commands:

    • Try /settings to see configuration
    • Try /list_admins to verify admin list
    • Try /show_flagged to see flagged names

  3. Test Dashboard:

    • Make a change in dashboard
    • Verify it takes effect
    • Check log channel (if set)

8. Fine-Tune Settings

Adjust Based on Results

  1. Too Many False Positives?

    • Increase similarity threshold
    • Add legitimate users to whitelist

  2. Missing Detections?

    • Decrease similarity threshold
    • Add more flagged names
    • Check admin list is complete

  3. Performance Issues?

    • Increase scan interval
    • Reduce recent joiners count

9. Set Up Whitelist (If Needed)

When to Whitelist

  • Legitimate users with similar names to admins
  • Bots that should be ignored
  • Trusted members

How to Whitelist

  1. Via Command:

    • Reply to user's message
    • Use /add_whitelist

  2. View Whitelist:

    /list_whitelist

10. Monitor and Maintain

Regular Checks

  1. Weekly:

    • Review log channel
    • Check for false positives
    • Update flagged names if needed

  2. Monthly:

    • Sync admin list (if admins changed)
    • Review settings
    • Check bot performance

  3. As Needed:

    • Add new flagged names
    • Adjust similarity threshold
    • Update whitelist

Next Steps