Files
buryan-infra/ops/telegram/README.md
T
buryan-agent 454140adf8 Telegram user bot: подготовлен целиком, ждёт api_id/api_hash
Telethon 1.45 установлен, скрипт читает каналы и отправляет сообщения в
шину ядра (telegram.post), состояние хранится между запусками — дублей нет.

Готово: конфиг-шаблон (600), юнит (не включён), cron каждые 15 минут с
проверкой TG_API_ID, фильтр по ключевым словам.

Проверено без ключей: завершается понятным сообщением, ничего не ломает.
Чтобы включить — заполнить /etc/hub-core/telegram.env и один раз войти
(код придёт в Telegram).
2026-10-19 20:03:59 +03:00

38 lines
1.8 KiB
Markdown

# Telegram user bot (Telethon)
Читает публичные каналы и складывает сообщения в шину ядра как события
`telegram.post`.
## Что готово
* `telethon 1.45.0` установлен на узле;
* скрипт `telegram_userbot.py`: подключение, чтение каналов, фильтр по
словам, состояние в `/var/lib/hub-core/telegram_state.json`
(повторно одни и те же сообщения не отправляет);
* конфиг-шаблон `/etc/hub-core/telegram.env` (600);
* юнит `hub-telegram.service` (oneshot) — не включён;
* cron `/etc/cron.d/hub-telegram` каждые 15 минут, запускается только
если `TG_API_ID` заполнен.
## Что нужно, чтобы включить
1. `api_id` и `api_hash` — https://my.telegram.org → API development tools.
2. Номер телефона и одноимённый код при первом входе (сессия сохранится
в `/var/lib/hub-core/telegram`).
3. Список каналов (`@name`) — в `TG_CHANNELS`.
4. Опционально `TG_KEYWORDS` — фильтр по словам.
Заполнить `/etc/hub-core/telegram.env`, затем:
```
set -a; . /etc/hub-core/telegram.env; set +a
python3 /opt/hub-core/telegram_userbot.py # первый вход спросит код
```
После первого успешного входа cron подхватит сам.
## Проверено без ключей
Скрипт завершается строкой «не настроено: нужны TG_API_ID...» и не падает —
служба и cron остаются в безопасном состоянии.