Telegram Support Bot

Streamline customer support with a bot that creates a dedicated forum topic for each user, enabling your team to manage conversations efficiently.

Get Started Learn How It Works

How it works

Get your support bot running in three simple steps

Create your bot and operator group

Create a new Telegram bot via @BotFather and set up a supergroup with Forum/Topics enabled. Add your bot to the group with Manage Topics permission.

Configure and install

Clone the repository, install dependencies, and configure your .env file with your bot token and operator group ID:

git clone https://github.com/apkuzmin/telegram-support-bot.git
cd telegram-support-bot
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Create your .env file:

BOT_TOKEN=123456:ABCDEF_your_token_here
OPERATOR_GROUP_ID=-1001234567890
DB_PATH=./support_bot.sqlite3
LOG_MESSAGES=1

Start the bot

Run the bot and start receiving user messages:

python -m support_bot

When a user messages your bot, a new forum topic is automatically created in your operator group. All messages are mirrored bidirectionally — users see operator replies in their private chat, and operators work entirely within organized topics.

Key features

Everything you need for organized customer support

One topic per user

Each user gets a dedicated forum topic in your operator group, keeping conversations organized and easy to manage.

Bidirectional messaging

Messages flow seamlessly between users and operators. Users chat privately with the bot, operators reply from the forum topic.

Reply mirroring

Reply to any message in the thread and the context is preserved on both sides with proper reply links.

Automatic topic creation

No manual setup required. When a new user messages the bot, a topic is created automatically with their name and ID.

SQLite persistence

All routing, message links, and optional message history are stored in SQLite for reliable operation.

Built with aiogram 3

Modern async Python framework with robust Telegram Bot API support and clean architecture.

Explore by topic

Deep dive into specific areas

Setup & Configuration

Complete installation guide, environment configuration, and Telegram bot setup instructions.

Core Concepts

Understand the architecture, message flow, topic management, and database design.

Deployment Guides

Deploy to production with systemd, Docker, or your preferred platform.

API Reference

Detailed documentation of all classes, methods, and configuration options.

Ready to get started?

Follow our quickstart guide to have your support bot running in under 5 minutes.

Get Started Now