TG Inbox — centralized processing system for Telegram messages

Project: development of a CRM system for managing incoming messages from dozens of Telegram accounts in a single web interface.
Technologies: Python (FastAPI, SQLAlchemy, Telethon), PostgreSQL, HTML/JS, Tailwind, Telegram Bot API, Linux.

⸻

Project Goal

To automate the work of recruiters and operators by consolidating all Telegram messages into one system. To ensure quick responses, control the status of dialogues, and notify the team about new messages.

⸻

Main Functionality

1. Inbox (central panel)
• Display of dialogues in real-time.
• Automatic statuses.
• Filters by recruiter, Telegram account, status, or time.

2. Access system
• User roles: admin, recruiter, viewer.
• Recruiters see only their dialogues.
• If an account is unassigned, its dialogues are accessible to all recruiters in the category.
• The administrator has full access.

3. Message template module
• Creation, editing, and deletion of templates.
• Integration with Inbox — the ability to quickly insert a template when responding.
• Support for personal and global templates.

4. Telegram notifications
• An integrated Telegram bot sends messages to the group for each new incoming request.
• The message text and username are transmitted automatically.

5. Workers and multithreading
• Separate asynchronous worker for each Telegram account.
• Queue manager (Outbox Dispatcher) for sending without blocking.
• Automatic media saving and session status monitoring.

⸻

Result

A fully automated system has been created that:
• Collects all Telegram messages in a single interface;
• Automatically updates the statuses of dialogues;
• Supports response templates;
• Notifies the team via the Telegram bot in real-time.

The system operates stably on the server (Ubuntu) and is ready for scaling.