telegram-groupfactory

A Telegram bot for managing user groups with MongoDB backend and admin-only configuration.

Features

• ✅ Create and manage Telegram groups with default user lists
• ✅ Admin-only configuration (requires STAFF_CHAT_ID)
• ✅ User management with MongoDB storage
• ✅ QR code backup for session replication
• ✅ Interactive admin role selection for group creators
• ✅ Modular architecture with separation of concerns
• ✅ Telegram bot integration using Telethon

Architecture

The application follows a modular architecture with the following components:

1. Configuration: src/config.py - Application configuration with admin access control
2. Data Models: src/models/ - Data models for users and groups
3. Services: src/services/ - Business logic for user and group operations
4. Handlers:
   • src/handlers/user_handler.py - User management commands
   • src/handlers/group_handler.py - Group management commands
   • src/handlers/admin_handler.py - Admin-only configuration commands
5. Main Application: src/main.py - Entry point with callback and message routing

Setup

1. Create a .env file with your Telegram API credentials:

   TELETHON_API_ID=your_api_id
   TELETHON_API_HASH=your_api_hash
   TELEGRAM_BOT_TOKEN=your_bot_token
   TELETHON_TOKEN=your_session_token
   
   MONGODB_URI=mongodb://localhost:27017
   MONGODB_DATABASE=groupfactory
   MONGODB_COLLECTION=ghconfig
   
   STAFF_CHAT_ID=your_admin_chat_id
   FACTORY_BOT_ID=your_bot_id
   

2. Install dependencies:

   pip install -r requirements.txt
   

3. Run the application:

   python src/main.py
   

Docker

To run with Docker:

docker build -t telegram-groupfactory .
docker run telegram-groupfactory

Documentation

• ADMIN_IMPLEMENTATION.md - Admin-only configuration features
• CONFIGURATION_GUIDE.md - Complete user guide

Quick Start

Admin Commands (Admin Chat Only)

/admin_add_user <username>        - Add user to database
/admin_set_users <id1> <id2> ...  - Set default users for groups
/admin_add_users <id1> <id2> ...  - Add users to default list
/admin_remove_users <id1> <id2>   - Remove users from default list
/admin_get_users                  - Show current default users
/admin_set_qr <qr_code>           - Store QR backup data
/admin_get_qr                     - Retrieve QR backup data

User Commands

/create_group <name>              - Create group with default users
/users                            - List all users
/user <user_id>                   - Get user info
/help                             - Show all available commands

Available Commands

• /create_group <name> - Create a new group
• /add_users <group_id> <user_ids> - Add users to a group
• /get_group <group_id> - Get group information
• /users - List all users
• /user <user_id> - Get user information
• /add_user <user_id> <username> <name> - Add a new user
• /delete_user <user_id> - Delete a user