# Реестр Telegram-ботов **Обновлено:** 2026-10-14 **Проверено:** все пять ботов отвечают, имена подтверждены запросом к Telegram API. > **Значений токенов в этом файле нет и быть не должно.** > Токен каждого бота хранится ровно в одном месте — в `.env` соответствующего > сервиса на сервере, права 600. Копия — в Vaultwarden. См. раздел «Ротация». --- ## 1. Кто за что отвечает | Роль | Бот | ID | Режим работы | Кто использует | |---|---|---|---|---| | **Администратор** | `@Adm_buryans_bot` | 8653974364 | **опрос** (`getUpdates`) — двусторонний | `comms-agent` на CT 108 | | **Аварии и мониторинг** | `@Buryans_AlertBot` | 8668603602 | только отправка | self-healing, бэкапы, слежение за версиями | | **Доступы и регистрация** | `@Auth_buryans_bot` | 8698835423 | **вебхук** → n8n | workflow F6-2 (самообслуживание) | | **Рабочие задачи** | `@Work_Buryan_bot` | 8754535508 | только отправка | задачи Gitea, еженедельный отчёт | | **Медиа** | `@Media_buryans_bot` | 8760535198 | только отправка | медиа-стек (Sonarr, Radarr, Plex, Jellyfin) | Логика разделения простая: **один бот — одна роль — один владелец — одно место хранения токена.** Когда администратор, аварии и регистрация сидят на одном токене, невозможно ни понять, от кого пришло сообщение, ни отозвать доступ частично — а именно это и произошло 14.10.2026, когда три потребителя одновременно опрашивали бота Auth. --- ## 2. Правила, которые нельзя нарушать 1. **Один вебхук на всю инфраструктуру.** Вебхук — только у бота доступов (`@Auth_buryans_bot`). Telegram не разрешает одновременно вебхук и опрос: при попытке получить `TelegramConflictError` и бот перестаёт работать. 2. **Один опрашивающий бот.** Опрос — только у администратора (`@Adm_buryans_bot`). Два опрашивающих с одним токеном конфликтуют между собой точно так же, как опрос с вебхуком. 3. **Остальные три бота — только отправка.** У них не должно быть ни вебхука, ни опроса. Проверять командой из раздела 6. 4. **Токен — никогда в Git.** Ни в реестре, ни в workflow, ни в скрипте. Только `.env` (права 600) и Vaultwarden. 5. **Новый бот — новая строка в этой таблице.** Без записи в реестре бот считается временным и подлежит удалению. --- ## 3. Маршрутизация сообщений | Событие | Кто отправляет | Куда | |---|---|---| | Команды `/status`, `/issues`, `/runbook`, `/restart` | администратор, двусторонний | чат владельца и комната Matrix | | Падение сервиса, сбой бэкапа, восстановление | `@Buryans_AlertBot` | чат владельца | | Доступна новая версия образа | `@Buryans_AlertBot` | чат владельца + задача в Gitea | | Заявка на доступ, одобрение, выдача | `@Auth_buryans_bot` | чат владельца, кнопки одобрения | | Новая задача или изменение в Gitea | `@Work_Buryan_bot` | чат владельца | | События медиа-стека | `@Media_buryans_bot` | чат владельца | Чат владельца: `273442500`. --- ## 4. Где лежит токен каждого бота | Бот | Файл | Хост | |---|---|---| | `@Adm_buryans_bot` | `/opt/automation-lxc/telegram-admin-bot/.env` | CT 108 | | `@Buryans_AlertBot` | `/opt/automation-lxc/docker-compose.yml` (окружение n8n) и `.env` бота | CT 108 | | `@Auth_buryans_bot` | окружение workflow F6-2 (при переводе — в credentials n8n) | CT 108 | | `@Work_Buryan_bot` | ещё не подключён | — | | `@Media_buryans_bot` | ещё не подключён | — | --- ## 5. Ротация токена Достаточно одного действия, потому что у каждого бота ровно один владелец: 1. `@BotFather` → `/revoke` → выбрать бота → получить новый токен. 2. Записать новый токен в файл из таблицы раздела 4 (права 600). 3. Перезапустить соответствующий сервис: - администратор: `pct exec 108 -- bash -c 'cd /opt/automation-lxc/telegram-admin-bot && docker compose up -d --force-recreate'` - бот алертов: пересоздать контейнер `n8n` - бот доступов: обновить значение в credentials n8n через веб-интерфейс 4. Убедиться, что режим доставки не сбился (раздел 6). 5. Обновить запись в Vaultwarden. --- ## 6. Проверка состояния ```bash # на pve: проверяет всех ботов — имя, режим, вебхук (токены не печатает) bash /root/verify-bots.sh /root/bots-tokens.env ``` Ожидаемая картина: вебхук — только у `AUTH`, у остальных пусто. --- ## 7. История | Дата | Изменение | |---|---| | 2026-10-14 | Реестр создан. Обнаружено, что `@Adm_buryans_bot` использовался тремя потребителями одновременно (вебхук n8n, бот на VPS, бот на CT 108) — источник конфликта `TelegramConflictError`. | | 2026-10-14 | Дубль админ-бота на VPS остановлен, два бота на CT 108 и VPS сведены в одного `comms-agent`. | | 2026-10-14 | Выданы пять отдельных ботов; назначены роли согласно разделу 1. |