Managing Your Bot Through the Dashboard

Introduction

The Telegram Bot App Management Dashboard provides a comprehensive web-based interface for configuring moderation settings, monitoring group activity, analyzing user behavior, and managing subscriptions—all from a centralized control panel accessible from any device with a web browser. This powerful administrative interface transforms complex bot configuration into intuitive point-and-click operations while providing deep analytics and real-time monitoring capabilities that would be impossible through Telegram's native interface.

The dashboard is where you manage all your moderation activities, from simple toggles for enabling detection systems to analytics showing violation trends, user intelligence reports with behavioral risk scores, and real-time punishment feeds displaying moderation actions as they occur. Whether you manage a single small community or moderation across dozens of large groups, the same interface applies.

Dashboard Overview

Accessing the Panel

To access the management dashboard:

Visit the Telegram Bot App website
Click "Login with Telegram" or "Access Panel"
Complete Telegram authentication (you'll be redirected to Telegram to authorize)
Return to the dashboard—you'll see all groups where you're an admin and the bot is present

Important: You must add the bot to at least one group before you can access the panel. The authentication system verifies your admin relationship to groups monitored by the bot—without this verification, login won't work.

Main Navigation

The dashboard uses a clean, modern interface with primary navigation in the header:

Home: Landing page with quick stats and recent activity
Panel: Main group management interface (your primary workspace)
User Intelligence: Behavioral analysis and spam detection tools
Pricing: Subscription plans and feature comparison
Features: Complete feature list and capabilities
Learning Centre: Documentation and tutorials (you're reading one now!)
Support: Contact information and help resources

The Panel section contains most day-to-day administration activities, while User Intelligence provides deep analytics for investigating specific users or monitoring system-wide moderation activity.

Panel Dashboard View

The Panel page displays all groups where you're an administrator and the bot is active. Each group appears as a card showing:

Group name and avatar
Group handle (@groupname)
Member count
Subscription status badge (Free, Gold, Platinum, Ultimate)
Status indicator (whether group is "allowed" - activated for moderation)
Quick action buttons to manage the group

Use the search bar at the top to filter groups by name or handle—particularly useful if you administrate many communities. The groups are displayed in a virtualized list that efficiently handles even very large numbers of groups (20+) without performance degradation.

Group Management Interface

Clicking into a specific group opens the comprehensive management interface organized into three main tabs:

Info Tab:

Subscription status and upgrade options
Group administrators list (click any admin to view their intelligence report)
Group metadata (Telegram handle, invite link, last activity)
Quick links to open the group in Telegram

Statistics Tab:

Group Statistics: Overview metrics, activity stats, moderation efficiency, violation breakdown
Users Statistics: Top 50 active members, searchable by name/handle/ID/bio

Settings Tab:

Basic Protection: CAPTCHA, media restrictions, user management
AI Moderation: NSFW detection, sentiment analysis, spam detection, language enforcement
Language Settings: Language selection and enforcement options
Messages & Greetings: Welcome messages, group rules, bot behavior
Advanced Settings: Badwords filter, group status controls

This three-tab organization separates information viewing (Info and Statistics) from configuration (Settings), reducing clutter and making common tasks easy to locate.

Configuring Moderation Settings

Basic Protection Tab

The Basic Protection settings provide fundamental group management controls accessible to all subscription tiers:

User Management:

Enable CAPTCHA for new members (with configurable timeout and kick-on-failure options)
Ban other bots automatically
Limit anonymous users

Content Restrictions:

Block Videos, GIFs, Audio, Files, Text Messages (individual toggles)
Block Forwards
Block Invite Links

Each toggle includes a descriptive label explaining what it does. Changes save automatically—simply toggle the switch and the setting activates immediately for all new messages.

AI Moderation Tab

The AI Moderation settings control advanced detection systems, with some features restricted to premium tiers:

NSFW Content Detection (Premium - uses image scan quota):

Detect pornographic content
Detect racy/suggestive content
Detect spoofed content
Strict mode (combines porn + racy)
Image detection threshold slider (0-100%)

Media Scanning (Premium for some):

Scan pictures (Premium)
Scan GIFs (Premium)
Scan stickers (Premium)
Scan user profile pictures (Free)
Scan user profile text (Free)

Spam Detection (Free):

Enable spam finder (pattern-based)
Spam detection threshold slider (0-100%)
Enable AI spam detection (behavioral analysis, automatic kick at 0.75)

Toxicity & Sentiment Analysis (Premium):

Block profanities (1 min punishment)
Block insults (1 min punishment)
Block threats (5 min punishment)
Sentiment detection threshold slider (0-100%)

Premium-only features display a badge indicating subscription requirement and provide upgrade buttons for Free tier users.

Threshold Sliders

Three critical threshold sliders control detection sensitivity:

Image Detection Threshold:

Range: 0-100% (0.0-1.0 internally)
Default: 70%
Lower = more sensitive (catches borderline content, more false positives)
Higher = less sensitive (only catches obvious violations, fewer false positives)

Sentiment Detection Threshold:

Range: 0-100%
Default: 70%
Controls toxicity, profanity, insult, and threat detection sensitivity

Spam Detection Threshold:

Range: 0-100%
Default: 75%
Controls spam pattern detection sensitivity

Adjusting these sliders immediately affects future message analysis—there's no delay or save button required. Experiment with values and monitor violation statistics to find optimal settings for your community.

Language Settings Tab

Configure language enforcement with precise control:

Enable language guard toggle
Delete-only mode (remove without punishment)
Language selector dropdown with 43 supported languages from Arabic to Vietnamese

The language selector uses dropdown menus for easy selection. Choose the language your community primarily uses, enable the language guard, and messages in other languages will be automatically removed (and users punished unless delete-only mode is enabled).

Messages & Greetings Tab

Customize group interaction features:

Welcome Message:

Enable greeting toggle
Custom greeting text (textarea supporting formatting)

Group Rules:

Enable group rules toggle
Auto-generate rules based on settings (checkbox)
Custom rules text (textarea)

Bot Behavior:

Mute bot (prevent all bot messages)
Delete system messages (remove join/leave notifications)
Enable /link command

These settings control user-facing features that affect how members experience your group.

Advanced Settings Tab

Configure specialized features:

Badwords Filter:

Enable badwords filter toggle
Apply punishment vs. delete only
Add custom badwords (input field + add button)
View and remove existing badwords (list with delete buttons)

Group Status:

Group allowed (whether moderation is active)
Hide from statistics

The badwords interface provides point-and-click management—type a word, click Add, and it's immediately added to your filter list. Click the X next to any word to remove it.

Monitoring and Analytics

Group Statistics Dashboard

Access comprehensive metrics through Statistics > Group Statistics:

Overview:

Status (allowed/not allowed)
Total members
Total administrators
Bot presence verification
Profile picture and invite link status

Activity Metrics:

Total messages all-time
Total violations detected
Total punishment time administered (minutes)
Relationship between messages and moderation

Moderation Efficiency:

Punishment rate per 1,000 messages
Average punishment duration
Average messages per member (engagement indicator)

Recent Activity:

Last 7 days punishments
Last 30 days punishments
Trend analysis

Top Violations Breakdown:

Violations by type (pornography, toxic language, spam, etc.)
Exact counts for each category
Visual representation of which rules are most frequently violated

These statistics update in real-time as new data arrives, ensuring you always see current metrics.

Users Statistics

View and analyze member activity through Statistics > Users Statistics:

Search bar for filtering by name, handle, ID, or bio content
Top 50 most active users by message count
Each user card displays:
- Avatar
- Name and handle
- Total message count in this group
- Last seen timestamp
Click any user to view their full intelligence report

Use this feature to identify your most engaged community members, spot unusual activity patterns (extremely high message counts might indicate spam bots), or investigate specific users reported by members.

Subscription Management

Monitor and manage your subscription through multiple interfaces:

Subscription Status Page (accessible from group Info tab):

Current plan details (name, price, features)
Billing period (start date, end date)
Feature quotas (image scans, sentiment analyses, etc.)
Usage meters with real-time updates (WebSocket-powered)
Overage toggle (enable/disable pay-as-you-go)
Groups covered by this subscription
Connection status indicator

Billing History Page:

Current billing period summary
12 most recent invoice periods
Each invoice showing: Period number, dates, overage charges, payment status
Payment method management (redirects to Stripe portal)

The usage meters provide live updates as quota is consumed, with visual progress bars showing percentage used and exact counts (e.g., "450 / 500 image scans used"). This real-time visibility helps you understand whether your current plan meets your needs or whether an upgrade would be beneficial.

User Intelligence Features

Individual Intelligence Reports

Access deep behavioral analysis for any user:

Navigate to User Intelligence from main menu
Search by name, handle, or Telegram ID
View comprehensive report including:
- Spam rating (0.0-1.0 with risk level indicator)
- Violation statistics (confidence mean, median, 95th percentile, high confidence rate)
- Group activity (messages sent, groups joined)
- Complete violation history (chronological list with timestamps, types, confidence, reasons)

The spam rating is the same score used by AI Spam Intelligence to determine automatic kicks—scores of 0.75+ trigger removal when AI spam detection is enabled. Use intelligence reports to investigate suspicious users, verify enforcement decisions, or evaluate whether borderline users deserve second chances.

Live Punishment Feed

Monitor real-time moderation activity system-wide:

Navigate to User Intelligence > Live Punishments tab
Watch the stream of recent violations across all monitored groups
Each entry shows:
- User avatar and name
- Violation type and detailed reason
- Confidence score
- Relative timestamp
- Connection status (WebSocket health)
Click any punishment to view violator's full intelligence report

The live feed updates in real time as violations occur across your groups, so you can see which violations are happening now. Watch for patterns like multiple similar violations from different users (coordinated spam campaigns) or unusual violation types that might indicate new spam tactics.

Public API Documentation

Access programmatic intelligence data:

Navigate to User Intelligence > API Documentation tab
Review the REST API endpoint and format
Copy code examples in your preferred language:
- cURL (command line)
- JavaScript (fetch API)
- Python (requests library)
Replace example user ID with ID you want to query
Execute request to receive JSON with spam rating and risk level

The public API allows integration with external tools, enabling sophisticated workflows beyond the web interface.

Real-World Usage Patterns

Daily Moderation Routine

A typical daily moderation workflow using the dashboard:

Morning Check (5 minutes):
- Open Panel, review all group cards for status
- Check subscription usage meters for quota consumption
- Scan for any groups with elevated violation indicators
Weekly Deep Dive (30 minutes):
- Review Group Statistics for each major group
- Examine top violations breakdown to identify trends
- Check Users Statistics for new highly active members
- Review User Intelligence for users with elevated spam ratings (0.50+)
Monthly Strategic Review (60 minutes):
- Compare statistics month-over-month
- Adjust thresholds based on violation patterns
- Review subscription usage to determine if plan changes needed
- Update welcome messages or rules based on community evolution

This rhythm balances proactive monitoring with administrative efficiency.

Multi-Group Management

For administrators managing many communities:

Dashboard Organization:
- Use search to quickly locate specific groups
- Star or bookmark frequently accessed groups in browser
- Organize browser tabs with one per major group
Shared Settings Strategy:
- Develop "profiles" for similar group types (e.g., "strict moderation profile" for professional groups, "relaxed profile" for social groups)
- Apply consistent threshold settings across groups of same type
- Use notes to document why specific settings were chosen
Centralized Intelligence:
- Use User Intelligence to identify users causing problems across multiple groups
- Cross-reference violation patterns between communities
- Coordinate enforcement actions for users in multiple related groups

The dashboard's design supports scaling from single-group management to coordinating moderation across dozens of communities.

Settings Experimentation

When calibrating moderation settings:

Establish Baseline:
- Note current statistics (punishment rate, violation breakdown)
- Document current threshold settings
Make One Change:
- Adjust only one threshold at a time
- Document what changed and when
Monitor Impact (3-7 days):
- Watch Group Statistics for changes in violation patterns
- Review specific violations to verify quality
Evaluate and Iterate:
- If improvement, keep change
- If negative impact, revert and try different adjustment
- If unclear, wait longer before judging

This methodical approach prevents confusion about which changes caused which effects.

Best Practices

Save Important Views

While the dashboard doesn't have built-in bookmarking, you can bookmark specific pages in your browser:

Bookmark your main Panel view for quick access
Bookmark specific group management pages for communities you check frequently
Bookmark the Live Punishment Feed if you monitor it regularly

Browser bookmarks provide quick access without navigating through multiple menus.

Use Search Effectively

The search functions (groups, users) support partial matches and are case-insensitive:

Search groups by partial name: "cryp" finds "Cryptocurrency Discussion"
Search users by handle without @: "john" finds "@johnsmith"
Search users by bio keywords to find related accounts

Effective search usage dramatically speeds up navigation in large installations.

Review Mobile Experience

The dashboard is fully responsive and works on mobile devices, but some features (especially statistics with tables) are more comfortable on larger screens. Consider:

Use mobile for quick checks and toggle changes
Use desktop/tablet for deep statistics review and threshold calibration
Use mobile's Live Punishment Feed for monitoring on the go

Different device types excel at different administrative tasks.

Keep Settings Documented

Maintain a simple document (spreadsheet, note file) tracking:

Current threshold settings for each group
Reasoning behind specific configurations
When settings were last changed
Results of threshold experiments

This documentation creates institutional knowledge that persists even if moderation team membership changes.

Troubleshooting

"Cannot see my group in the dashboard"

Causes: Bot not added to group, you're not an admin, authentication hasn't updated

Solution: Verify bot is actually in the group as a member. Verify you have administrator rights in Telegram group settings. Try logging out and logging back in to refresh authentication.

"Changes not saving"

Causes: Network issue, browser cache, concurrent changes

Solution: Refresh the page to verify whether change actually saved. If not, try toggling the setting again. Clear browser cache if problems persist. Ensure stable internet connection.

"Usage meters showing 'disconnected'"

Causes: WebSocket connection lost, browser tab inactive too long

Solution: The dashboard should automatically reconnect within 30 seconds. If it remains disconnected, refresh the page. Check that browser doesn't have WebSocket blocking extensions enabled.

"Statistics seem outdated"

Causes: Cache delay, recent changes not yet reflected

Solution: Statistics update in near-real-time but may have 30-60 second delays. Refresh the page to ensure you're viewing latest data. If data is hours or days old, this indicates a system issue—report to support.

"Cannot access Stripe billing portal"

Causes: No active subscription, browser blocking popup

Solution: Payment method management only works for active paid subscriptions. Ensure your browser allows popups from the dashboard domain. Try using the direct link from the Billing History page instead of the button.

Conclusion

The Telegram Bot App Management Dashboard transforms bot administration from complex command-line operations into intuitive point-and-click workflows while providing sophisticated analytics and monitoring capabilities that enable data-driven community management. Whether you're configuring basic protection rules, calibrating AI detection thresholds, monitoring real-time violations, or analyzing user behavior patterns, the dashboard provides the tools you need in a unified, accessible interface.

Master the dashboard's features to maximize your moderation effectiveness while minimizing time investment. The combination of simple toggles for common tasks and deep analytics for strategic decisions ensures that administrators of all skill levels can successfully manage their communities. Explore the interface, experiment with settings while monitoring their effects through statistics, and develop administrative workflows that match your community's unique needs.

Quick Links