Stop Configuring Telegram Bots via Commands: Building a Visual Moderator with Mini Apps

DMITRY — Sun, 18 Jan 2026 20:11:33 +0000

Managing large Telegram chats is a familiar challenge. Once a chat grows beyond 100–200 members, typical problems start to appear: spam, flooding, scam links, bots, and generally toxic behavior.

The market already offers well-known solutions — Combot, Rose, and other popular bots. They are powerful and battle-tested, but they share one major drawback: configuration via text commands.

Setting up filters, limits, exclusions, and rules often looks like working in a console:
/settings
/filter add ...
/warn limit 3
For technically experienced users, this is acceptable. But for community owners, channel administrators, and moderators, it creates an unnecessary barrier to entry.

In this article, I want to share how I tried to solve this problem — and why Telegram Mini Apps turned out to be the perfect tool for it.

*The UX Problem of Telegram Moderation Bots
*
The main issue with most moderation bots is not functionality, but user experience:
• commands must be memorized or constantly looked up;
• it’s hard to quickly understand which rules are currently active;
• there is little transparency — a message gets deleted, but why?

As a result, chat management starts to feel like working with a CLI. It’s efficient, but inconvenient for people who simply want to manage a community rather than learn command syntax.

My goal was to make moderation:
• visual,
• predictable,
• accessible without reading documentation.

*Why Telegram Mini Apps
*
With the introduction of Telegram Mini Apps (web applications embedded directly into the Telegram client), it became clear that this was the missing piece in the bot ecosystem.

Mini Apps make it possible to:
• move administration into a full-fledged UI;
• use familiar interface elements (switches, sliders, lists);
• display analytics and logs in real time.

This is how SmartMod was born — a Telegram moderation bot where all administrative control is implemented via a Mini App.

*What Moderation Looks Like in Practice
*
Visual Control Panel

Instead of commands, there is a dashboard.

When an administrator opens the Mini App, they immediately see:
• how many messages have been checked;
• how many violations occurred today;
• which rules are triggered most often.

This provides a clear overview of the chat’s current state without digging through logs or bot messages.

*One-Click Rule Configuration
*
All core moderation features are configured through the interface:
• anti-spam and anti-flood protection;
• link and forward restrictions;
• caps and media filtering;
• AI moderation — for ambiguous cases where simple rules and regular expressions are not enough.

No text commands. Only switches, sliders, and checkboxes.

*Transparency of Bot Actions
*
One of the most common issues with automated moderation is the “black box” effect.

SmartMod includes an action log directly in the Mini App, showing:
• who was muted or banned;
• at what time;
• and which specific rule was triggered.

This makes dispute resolution easier and increases trust in automated moderation.
*A Bit About the Technical Implementation
*
The project was designed from the start to handle high loads with minimal latency.

The technology stack includes:
• Backend: Cloudflare Workers
A serverless architecture with fast response times worldwide.
• Database: Cloudflare D1
An SQLite database running on Cloudflare’s edge infrastructure.
• Frontend: React + Vite + TailwindCSS
A compact and fast interface optimized for Mini Apps.
• UI: Shadcn/UI
A clean, minimalistic design without visual clutter.

As a result, the Mini App opens inside Telegram almost instantly and does not feel like an external website.
*How to Try It
*
The bot is available for free.

👉 Telegram bot: @SmartModIA_bot

Just add the bot to your chat and grant it administrator permissions.

I’d appreciate any feedback — especially comparisons between visual UI-based management and the traditional command-based approach.

DEV Community: DMITRY

Stop Configuring Telegram Bots via Commands: Building a Visual Moderator with Mini Apps