TG Inbox — system centralnego przetwarzania wiadomości Telegram

Projekt: rozwój systemu CRM do zarządzania przychodzącymi wiadomościami z dziesiątek kont Telegram w jednym interfejsie webowym.
Technologie: Python (FastAPI, SQLAlchemy, Telethon), PostgreSQL, HTML/JS, Tailwind, Telegram Bot API, Linux.

⸻

Cel projektu

Zautomatyzować pracę rekruterów i operatorów, łącząc wszystkie wiadomości Telegram w jeden system. Zapewnić szybką odpowiedź, kontrolę statusów dialogów i powiadomienia zespołu o nowych wiadomościach.

⸻

Podstawowa funkcjonalność

1. Inbox (centralny panel)
• Wyświetlanie dialogów w czasie rzeczywistym.
• Automatyczne statusy.
• Filtry według rekrutera, konta Telegram, statusu lub czasu.

2. System dostępu
• Role użytkowników: admin, rekruter, widz.
• Rekruter widzi tylko swoje dialogi.
• Jeśli konto nie jest przypisane — jego dialogi są dostępne dla wszystkich rekruterów w kategorii.
• Administrator ma pełny dostęp.

3. Moduł szablonów wiadomości
• Tworzenie, edytowanie i usuwanie szablonów.
• Integracja z Inbox — możliwość szybkiego wstawienia szablonu podczas odpowiedzi.
• Wsparcie dla szablonów osobistych i globalnych.

4. Powiadomienia Telegram
• Zintegrowany bot Telegram wysyła wiadomości do grupy przy każdym nowym przychodzącym zapytaniu.
• Tekst wiadomości i nazwa użytkownika są przekazywane automatycznie.

5. Workerzy i wielowątkowość
• Oddzielny asynchroniczny worker dla każdego konta Telegram.
• Menedżer kolejki (Outbox Dispatcher) do wysyłania bez blokad.
• Automatyczne zapisywanie mediów i monitorowanie stanu sesji.

⸻

Wynik

Stworzono w pełni zautomatyzowany system, który:
• Zbiera wszystkie wiadomości Telegram w jednym interfejsie;
• Automatycznie aktualizuje statusy dialogów;
• Wspiera szablony odpowiedzi;
• Powiadamia zespół przez bota Telegram w czasie rzeczywistym.

System stabilnie działa na serwerze (Ubuntu) i jest gotowy do skalowania.