domovoy_bot/FORUM_TOPICS_SETUP.md

🏢 TELEGRAM FORUM TOPICS — НАСТРОЙКА БОТА

Обновлено: 4 марта 2026 Статус: ✅ НАСТРОЕНО

---

📋 ЧТО СДЕЛАНО

Бот теперь поддерживает Telegram Forum Topics — отдельные ветки внутри чата!

10 тем настроено:

№	Тема	ID	Куда отправляет бот
1	Общий чат	1	Рассылки, объявления, уведомления
2	Важные объявления	6258	Объявления жильцов (/ad)
3	Ссылки	6265	—
4	Мемы	6262	—
5	Для автовладельцев	6266	—
6	Потеряшки	6263	Потерянные вещи (/lost)
7	Собрания собственников	6261	События, собрания (/events)
8	Вывоз КГМ	6264	Напоминания о вывозе мусора
9	Переписка с УО	6260	—
10	Важные телефоны	6259	—

---

⚙️ КОНФИГУРАЦИЯ

.env

# Telegram Forum Topics
FORUM_ENABLED=true
TOPIC_GENERAL=1
TOPIC_ADS=6258
TOPIC_LINKS=6265
TOPIC_MEMES=6262
TOPIC_AUTO=6266
TOPIC_LOSTFOUND=6263
TOPIC_MEETINGS=6261
TOPIC_KGM=6264
TOPIC_UO=6260
TOPIC_PHONES=6259

config.py

FORUM_TOPICS = {
    'general': 1,
    'ads': 6258,
    'links': 6265,
    'memes': 6262,
    'auto': 6266,
    'lostfound': 6263,
    'meetings': 6261,
    'kgm': 6264,
    'uo': 6260,
    'phones': 6259,
}

---

🚀 КАК БОТ ИСПОЛЬЗУЕТ ТЕМЫ

Объявления (/ad)

# Отправка в тему "Важные объявления"
await bot.send_message(
    chat_id=ADMIN_CHAT_ID,
    message_thread_id=get_topic_id('ads'),  # 6258
    text="Объявление..."
)

Рассылки от админа

# Отправка в "Общий чат"
await bot.send_message(
    chat_id=ADMIN_CHAT_ID,
    message_thread_id=get_topic_id('general'),  # 1
    text="Рассылка..."
)

События (/events)

# Отправка в "Собрания собственников"
await bot.send_message(
    chat_id=ADMIN_CHAT_ID,
    message_thread_id=get_topic_id('meetings'),  # 6261
    text="Событие..."
)

---

📊 ЧТО КУДА ОТПРАВЛЯЕТСЯ

Тип контента	Тема	ID
Объявления жильцов (/ad)	Важные объявления	6258
Рассылки админа	Общий чат	1
Напоминания ЖКХ	Общий чат	1
Отключения (вода, свет)	Общий чат	1
События дома	Собрания собственников	6261
Потерянные вещи	Потеряшки	6263
Вывоз КГМ	Вывоз КГМ	6264

---

🔧 ДОБАВЛЕНИЕ НОВЫХ ТЕМ

1. Добавь в .env:

   TOPIC_NEW=12345
   

2. Обнови config.py:

   FORUM_TOPICS = {
       ...
       'new': TOPIC_NEW,
   }
   

3. Используй в коде:

   await bot.send_message(
       chat_id=config.ADMIN_CHAT_ID,
       message_thread_id=config.get_topic_id('new'),
       text="..."
   )
   

4. Перезапусти бота:

   cd /home/matrixhasyou/domovoy_bot
   ./stop.sh && ./run.sh
   

---

🎯 УМНЫЙ АНАЛИЗАТОР ТЕМ

Бот автоматически определяет тему по тексту сообщения:

Ключевые слова	Тема
"продам", "куплю", "отдам"	Важные объявления
"потерял", "нашёл", "ключи"	Потеряшки
"собрание", "голосование"	Собрания собственников
"мусор", "вывоз", "КГМ"	Вывоз КГМ
"сантехник", "электрик"	Важные телефоны

---

✅ ПРОВЕРКА РАБОТЫ

1. Создай объявление:

   /ad
   

   → Должно появиться в теме "Важные объявления"

2. Отправь рассылку:

   /broadcast
   

   → Должно появиться в "Общем чате"

3. Создай событие:

   /event_add
   

   → Должно появиться в "Собрания собственников"

---

🛠️ ОТЛАДКА

Бот отправляет не в ту тему:

# Проверь .env
cat .env | grep TOPIC_

# Проверь config.py
python -c "from config import FORUM_TOPICS; print(FORUM_TOPICS)"

Ошибка "Invalid message_thread_id":

# Проверь что тема существует
# Открой тему в Telegram и проверь URL

Бот не видит сообщения из тем:

# Проверь права бота в каждой теме
# Бот должен быть админом со доступом к сообщениям

---

by MatrixHasYou 🏠