Telegram-бот

Материал из DPA
Версия от 23:45, 26 января 2021; Yaroslav Goryaev (обсуждение | вклад) (Новая страница: «=Настройка Telegram-бота для оповещений= Возможны два варианта работы рассылки уведомлений...»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к навигации Перейти к поиску

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

Возможны два варианта работы рассылки уведомлений через Telegram, за настройку режима работы отвечает опция RunDPAMessengerOptions. Если галка UseRunDPAMessenger снята, то бот работает в автономном режиме, иначе в режиме клиента глобального сервиса рассылки сообщений. По умолчанию установлен вариант работы как глобальный сервис рассылки.
Данная настройка расположена Settings gear.png => Микросервисы => Messenger => RunDPAMessengerOptions

Автономный вариант работы сервиса

  1. Необходимо зарегистрировать собственного Telegram-бота через бота @BotFather, при регистрации нужно выбрать имя бота и получить токен вашего бота.
  2. Внести данные своего бота в настройку Settings gear.png => Микросервисы => Messenger => TelegramBotOptions
  3. На данном этапе требуется подключить пользователей, которые должны получать уведомления к боту. Настройка производится непосредственно из профиля пользователя, кнопка "Подключить Telegram":
    • Tlgr user connect.png
    • Далее откроется окно с QR-кодом и веб-ссылкой на Telegram-бота, ссылку можно открыть кликнув на нее, либо отсканировав QR-код. Telegram-бот должен быть активирован тем же пользователем, которому принадлежит профиль пользователя в системе DPA. При успешном подключении у пользователя появится информации о подключении в профиле:
    • Tlgr user connect done.png


Для проверки отправки сообщений в настройках Messenger-а нужно перейти на вкладку "Отправить сообщение", где заполнить "Транспорт" chat id пользователя (указан в профиле), а также тему и тест сообщения, после заполнения нажать кнопку "Отправить".

Test message.png

Результат отправки сообщения можно посмотреть на вкладке "История сообщений"

Как клиент глобального сервиса рассылки сообщений

Для работы мессенджера DPA должна иметь выход в интернет. Настройки мессенджера расположены в разделе

Settings gear.png => Messenger

1. Подключение системы к глобальному сервису рассылки производится на вкладке подключение, необходимо заполнить поле "Название организации" и отправить запрос:

Tlgr connect.png

Статус запроса изменится на "Ожидает подтверждения".

После подтверждения администратора со стороны компании Экстенсив статус будет изменен на "Подключено"

Tlgr connect done.png

Данный статус означает, что система подключена к сервису рассылки уведомлений через Telegram, после этого можно приступить к настройке подключения пользователей, для получения уведомлений через Telegram.

2. Подключение своей учетной записи к Telegram-боту Процедуру подключения необходимо проделать каждому пользователю индивидуально. Настройка производится непосредственно из профиля пользователя, кнопка "Подключить Telegram":

Tlgr user connect.png

Далее откроется окно с QR-кодом и веб-ссылкой на Telegram-бота, ссылку можно открыть кликнув на нее, либо отсканировав QR-код. Telegram-бот должен быть активирован тем же пользователем, которому принадлежит профиль пользователя в системе DPA. При успешном подключении у пользователя появится информации о подключении в профиле:

Tlgr user connect done.png

Для проверки отправки сообщений в настройках Messenger-а нужно перейти на вкладку "Отправить сообщение", где заполнить "Транспорт" chat id пользователя (указан в профиле), а также тему и тест сообщения, после заполнения нажать кнопку "Отправить".

Test message.png

Результат отправки сообщения можно посмотреть на вкладке "История сообщений"