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) та готова до масштабування.