Настройка сервера для отправки оповещений в Telegram

Данная статья описывает 2 основных момента:

  1. Создание бота Telegram
  2. Настройка Fort Monitor 3 для включения возможности отправки извещений по событиям в группу Telegram или конкретному пользователю.

Предварительные требования:

  • Зарегистрированный аккаунт в Telegram

Создание бота

Для создания бота в Telegram необходимо начать диалог с "главным" ботом - @BotFather.

Для создания своего бота в диалоге с @BotFather необходимо отправить команду

<span class="crayon-o">/</span><span class="crayon-v">newbot
</span>

В ответ будет предложено ввести название бота и название пользователя для аккаунта бота. Название будет отображаться в окне диалога, а имя - используется для ссылок на бота.

mceclip0.png

После успешного задания названия и имени будет выдана короткая ссылка на бота (t.me/FortMonitorHostingBot) и токен для использования этого бота в Fort Monitor.

В случае компрометации токена можно сгенерировать новый (в случае, если у вас зарегистрирован не один бот, будет предложен выбор - для какого бота производится замена токена):

<span class="crayon-v"><span class="crayon-o">/</span>revoke</span>

Старый токен при этом работать перестанет.

Далее можно задать боту его описание, которое будет выводиться в окне добавления бота:

<span class="crayon-v"><span class="crayon-o">/</span>setdescription</span>

mceclip2.png

Также можно задать текст, который будет отображаться в описании бота в окне информации о пользователе:

<span class="crayon-v"><span class="crayon-o">/</span>setabouttext</span>

mceclip3.png

Ну и, наконец, задаем иконку для бота:

<span class="crayon-v"><span class="crayon-o">/</span>setuserpic</span>

mceclip4.png

После всех этих настроек можем приступать к настройке FortMonitor.

Настройка FortMonitor

Полученный на этапе создания бота токен необходимо занести в настройки сервера.

На текущий момент эти настройки хранятся в БД в таблице f_server_properties.

В эту таблицу необходимо добавить параметры:

  • TelegramBotInnerName - имя бота в Telegram (в примере это FortMonitorHostingBot)
  • TelegramBotName - название бота (в примере это FortMonitor Hosting)
  • TelegramBotToken - токен

Также есть возможность задать доступ к API Telegram посредством http-proxy:

  • TelegramProxyHost - IP-адрес прокси-сервера
  • TelegramProxyPort - порт прокси-сервера

mceclip0.png

После задания настроек необходимо перезапустить службу fmKeeperService.

Каждый пользователь, который хочет получать уведомления в Telegram из Fort Monitor, должен написать этому боту сообщение, т.к. Telegram не позволяет ботам отправлять сообщения пользователям, не подписанным на них.

Для быстрого доступа пользователям можно будет выдать быстрые ссылки на бота (открываются как в браузере, так и в приложении Telegram):

<span class="crayon-v">t.me/FortMonitorHostingBot</span>

FortMonitorHostingBot - название пользователя, заданного на этапе создания бота.