Getting Started

How to Add the Bot to Your Group

1. Open Telegram and search for @eGuardian_bot
2. Click on the bot and select "Add to Group"
3. Choose your group from the list
4. Grant the bot admin permissions for full functionality

Basic Configuration

Enable Basic Detectors & URL Management

After adding the bot to your group, use the setup command to configure basic protection:

This command allows you to:

• Enable/disable spam detectors (Forwarded, Story, Button and blacklisted URLs detection etc.)
• Add whitelisted DOMAINs and LINKs that won't be flagged as spam
• Configure basic group settings

Whitelisting Domains & Links

You can whitelist trusted DOMAINs and LINKs to prevent false positives:

• Add trusted DOMAINs (e.g., example.com), allows any link on this domain.
• Add only specific LINKs (e.g., https://example.com/my-group), allows only this link on the domain.
• View and manage your whitelist through the setup interface

AI-Powered Features

Adding Gemini API Keys

eGuardian uses Google's Gemini AI for advanced spam detection and generative features.

API Key Management

• Admin Only: Only group admins can add or update API keys
• Multiple Keys: Add multiple Gemini API keys to distribute usage and stay within free limits
• Encrypted Storage: All API keys are encrypted using industry-standard encryption
• Privacy First: Keys are never displayed after being added - not even to admins or developers
• Zero Access: We cannot access your API keys - they remain encrypted in our database

Get Your Gemini API Key

1. Visit Google AI Studio
2. Sign in with your Google account
3. Create a new API key
4. Add it to eGuardian through the web interface by logging into your account on this website.

AI Feature Options

You can choose how to use AI in your group:

• AI Spam Detection: Intelligent detection of spam, scams, and malicious content, text and media
• AI Generative Features: Content generation, assistance and automated translation. Global communication made easy.
• Translate: Set your group's language by using /setup command
• Custom Setup: Enable only the features you need

Customizing AI Spam Detection Prompts

Every group has unique needs and different definitions of spam. eGuardian allows you to customize the AI detection prompt:

• Define what counts as spam for your specific community
• Set tolerance levels for different types of content
• Add context about your group's purpose and rules
• Fine-tune detection sensitivity to reduce false positives

Democratic Defenders System

What are Defenders?

Defenders are regular and trusted community members who help moderate the group without admin privileges. They help when admins are idle without any special rights.

Adding Defenders

1. Identify trusted, active group members
2. Use admin commands to grant defender status

Managing Defenders

Use the /defenders command to add or remove defenders:

Defender Configuration

Use /defendersconf to configure defender settings:

• Expiration Time: Set how long before an active vote expires
• Minimum Votes: Configure how many defender votes are needed to take action

Using the /react Command

Defenders use the /react command to vote on potentially problematic messages:

• When enough defenders vote, the message is automatically removed
• All votes are logged for transparency
• Note: Defenders are exempt from any SPAM detection as they are trusted members

Manual Moderation Commands

Dealing with Known Spammers

Sometimes spammers join with deceptive names like "Admin", "Owner", or without a username. Our manual moderation commands help you act quickly.

Quick Moderation Using User ID

When a suspicious user joins, the bot displays their User ID. You can immediately restrict them:

Why Use User ID?

• Works even if the user has no username
• No need to wait for them to send a message
• Instantly displayed when user joins the group
• Prevents spammers from causing damage before being stopped

Transparent Logging System

Public Log Channel

eGuardian maintains a dedicated public log channel for complete transparency and unlimited history.

What Gets Logged?

• Exact content sent by spammers (text, media, links)
• Why the user was restricted (spam type, detection method)
• Who took the action (admin name, defender votes, automated systems)
• When the action occurred (timestamp)
• User details (ID, username, name)
• All defender voting activity and decisions

Benefits of Public Logging

1. Unlimited History

Unlike Telegram's built-in logs (48 hours only), our log channel preserves records as long as Telegram chats exist - practically unlimited.

2. Complete Transparency

• Anyone can review why a user was restricted
• Members can see spammer activity and understand moderation decisions
• Builds trust in the group
• Prevents abuse of admin/defenders powers

3. Historical Reference

Admins can search the log channel to review past actions:

• Search by User ID, Username, Name etc. to see all actions taken against a specific user
• Review why you restricted someone months ago
• Identify patterns in spammer behavior
• Reference previous decisions when dealing with appeals. Extremely useful for understanding context.

4. Accountability & Trust

• Members can verify that restrictions were justified
• Defenders' votes are publicly recorded
• Admins can review their own actions
• Creates a culture of fair and transparent moderation

5. Evidence Preservation

• Spam content is preserved even after deletion from main group
• Useful for reporting persistent spammers to Telegram
• Helps identify coordinated spam campaigns
• Provides evidence in case of disputes