Feature Descriptions

Detailed descriptions of BeefyGuard features.

Exclusive Features

Portal Verification

Gate access to your private groups through a verification portal. Users tap "Verify" in your public channel, complete a CAPTCHA (button click, math problem, or emoji selection), and receive a one-time invite link that only works for them. This blocks bots and ensures only real humans can join.

Key Benefits:

Blocks automated spam bots
Each invite link works once only
Three CAPTCHA types for different security levels
Seamless user experience

Profile Picture Matching

The only Telegram bot that detects profile picture impersonation. Scammers often copy admin profile pictures to trick members. BeefyGuard uses image hashing to detect copied profile pictures and automatically bans impersonators.

CAS Database Integration

Connected to Combot Anti-Spam database with 1.2M+ banned users. When someone joins your group, BeefyGuard checks if they're a known spammer and can automatically ban them. Silent mode logs the ban without notifying the group.

Global Bans Network

When a scammer is caught in one BeefyGuard-protected group, they're automatically banned from all other groups using BeefyGuard. This creates a powerful protection network where one detection protects thousands of communities.

Impersonation Detection

How It Works

The bot continuously monitors group members and compares their names to your admin list. When a match is found (based on similarity threshold), the bot takes action.

Key Components

Similarity Algorithm: Uses fuzzy matching to detect similar names
Real-time Monitoring: Detects changes immediately
Background Scanning: Periodic scans of all members
Profile Picture Matching: Detects copied admin profile pictures

Configuration

Similarity threshold (0.0-1.0)
Check on join/name change
Scan intervals
Action types

Admin Management

Automatic Syncing

Use /sync_admins to automatically track all current group admins. The bot maintains this list and uses it for detection.

Manual Management

Add or remove admins manually using commands or dashboard.

Spam Detection Features

Cross-Chat Quote Spam

Scammers use Telegram's "Reply in another chat" feature to quote messages from external scam channels. BeefyGuard detects this technique and takes action. The bot tracks which channels are being used for spam and can auto-ban after a configurable threshold.

Linked Channel Reply + Spam Link

Detects when users reply to your group's linked channel posts but include spam links in their reply. The bot extracts hidden URLs from text_link entities (clickable text that hides the actual URL) and checks against your domain whitelist.

Fake Support Scam Detection

Scammers often reply to regular members saying "I can help you" or "Contact support at...". BeefyGuard detects when low-activity users reply to non-admin messages and tracks repeat attempts, automatically banning after the configured threshold.

First Message Link Auto-Ban

Instantly bans users whose very first message in the group contains a link. This catches drive-by spammers who join only to post one link and leave. Configurable grace period (1-168 hours) prevents false positives for established members.

Moderation Features

Anti-Spam (Flood Detection)

Detects when users send too many messages in a short time period. Configurable limits (1-100 messages), time windows (1-300 seconds), and actions (mute, warn, kick, ban).

Anti-Raid

Protects against coordinated join attacks. Detects when too many users join in a short time and can lock down the group automatically.

Filter System

Word Filter

Blocks messages containing specific words. Supports case sensitivity and custom actions (delete, warn, mute, kick, ban).

Link Filter

Controls link sharing. Can allow, deny, or use whitelist mode. Whitelist trusted domains like your official website.

Media Filter

Restricts specific media types. Can limit photos, videos, GIFs, stickers, files, and voice messages. Set file size limits up to 2GB.

Logging Features

Forum Topic Logging

Use a single log channel for multiple groups by enabling Forum Mode. Each group gets its own organized topic, so logs don't get mixed up. Create topics automatically from the dashboard or set the topic ID manually.

One-Tap Mod Actions

Every detection log includes interactive buttons. Whitelist, ban, unban, or mute users directly from the log channel with one tap. No need to type commands - instant moderation from anywhere.

Log-Only Mode

Send all service messages (bans, detections, warnings) exclusively to your log channel instead of the main group. Keeps busy groups clean while keeping admins fully informed.

Announcement System

Channel Forwarding

Automatically forwards messages from your announcement channel to groups. Supports silent forwarding and auto-pinning with configurable duration.