Настройка сервера для отправки оповещений в Telegram
Данная статья описывает 2 основных момента:
- Создание бота Telegram
- Настройка Fort Monitor 3 для включения возможности отправки извещений по событиям в группу Telegram или конкретному пользователю.
Предварительные требования:
- Зарегистрированный аккаунт в Telegram
Создание бота
Для создания бота в Telegram необходимо начать диалог с "главным" ботом - @BotFather.
Для создания своего бота в диалоге с @BotFather необходимо отправить команду:
/newbot
В ответ будет предложено ввести название бота и название пользователя для аккаунта бота. Название будет отображаться в окне диалога, а имя — используется для ссылок на бота.
После успешного задания названия и имени будет выдана короткая ссылка на бота (t.me/FortMonitorHostingBot) и токен для использования этого бота в Fort Monitor.
В случае компрометации токена можно сгенерировать новый (в случае, если у вас зарегистрирован не один бот, будет предложен выбор — для какого бота производится замена токена), для этого отправьте команду "/revoke". Старый токен при этом работать перестанет.
Далее можно задать боту его описание, которое будет выводиться в окне добавления бота:
/setdescription
Также можно задать текст, который будет отображаться в описании бота в окне информации о пользователе:
/setabouttext
Ну и, наконец, задаем иконку для бота:
/setuserpic
После всех этих настроек можем приступать к настройке FortMonitor.
Настройка FortMonitor
Полученный на этапе создания бота токен необходимо занести в настройки сервера.
На текущий момент эти настройки хранятся в БД в таблице f_server_properties.
В эту таблицу необходимо добавить параметры:
- TelegramBotInnerName - имя бота в Telegram (в примере это FortMonitorHostingBot)
- TelegramBotName - название бота (в примере это FortMonitor Hosting)
- TelegramBotToken - токен
Также есть возможность задать доступ к API Telegram посредством http-proxy:
- TelegramProxyHost - IP-адрес прокси-сервера
- TelegramProxyPort - порт прокси-сервера
После задания настроек необходимо перезапустить службу fmKeeperService.
Каждый пользователь, который хочет получать уведомления в Telegram из Fort Monitor, должен написать этому боту сообщение, т.к. Telegram не позволяет ботам отправлять сообщения пользователям, не подписанным на них.
Для быстрого доступа пользователям можно будет выдать быстрые ссылки на бота (открываются как в браузере, так и в приложении Telegram):
t.me/fort_monitor_support_bot
fort_monitor_support_bot - название пользователя, заданного на этапе создания бота.