TG Inbox — система централизованной обработки сообщений Telegram

Проект: разработка CRM-системы для управления входящими сообщениями с десятков Telegram-аккаунтов в едином веб-интерфейсе.
Технологии: Python (FastAPI, SQLAlchemy, Telethon), PostgreSQL, HTML/JS, Tailwind, Telegram Bot API, Linux.

⸻

Цель проекта

Автоматизировать работу рекрутеров и операторов, объединив все Telegram-сообщения в одну систему. Обеспечить быструю реакцию, контроль статусов диалогов и уведомление команды о новых сообщениях.

⸻

Основной функционал

1. Inbox (центральная панель)
• Отображение диалогов в режиме реального времени.
• Автоматические статусы.
• Фильтры по рекрутеру, Telegram-аккаунту, статусу или времени.

2. Система доступов
• Роли пользователей: admin, recruiter, viewer.
• Рекрутер видит только свои диалоги.
• Если аккаунт не закреплен — его диалоги доступны всем рекрутерам категории.
• Администратор имеет полный доступ.

3. Модуль шаблонов сообщений
• Создание, редактирование и удаление шаблонов.
• Интеграция с Inbox — возможность быстро вставить шаблон при ответе.
• Поддержка персональных и глобальных шаблонов.

4. Telegram-уведомления
• Интегрированный Telegram-бот отправляет сообщения в группу при каждом новом входящем обращении.
• Текст сообщения и имя пользователя передаются автоматически.

5. Воркеры и многопоточность
• Отдельный асинхронный воркер для каждого Telegram-аккаунта.
• Менеджер очереди (Outbox Dispatcher) для отправки без блокировок.
• Автоматическое сохранение медиа и мониторинг состояния сессий.

⸻

Результат

Создана полностью автоматизированная система, которая:
• Собирает все Telegram-сообщения в едином интерфейсе;
• Автоматически обновляет статусы диалогов;
• Поддерживает шаблоны ответов;
• Уведомляет команду через Telegram-бота в режиме реального времени.

Система стабильно работает на сервере (Ubuntu) и готова к масштабированию.