Telegram-бот: различия между версиями

Материал из DPA
Перейти к навигации Перейти к поиску
(Новая страница: «=Настройка Telegram-бота для оповещений= Возможны два варианта работы рассылки уведомлений...»)
 
 
(не показано 14 промежуточных версий этого же участника)
Строка 1: Строка 1:
=Настройка Telegram-бота для оповещений=
+
Данная настройка актуальна, при использовании автономного режима работы микросервиса Messenger, подробнее о настройке режима работы микросервиса в разделе[[установка_микросервиса| установка.]]<br>
Возможны два варианта работы рассылки уведомлений через Telegram, за настройку режима работы отвечает опция '''RunDPAMessengerOptions'''. Если галка UseRunDPAMessenger снята, то бот работает в автономном режиме, иначе в режиме клиента глобального сервиса рассылки сообщений. По умолчанию установлен вариант работы как глобальный сервис рассылки.
+
'''Внимание!''' Для работы вашего бота опция '''RunDPAMessengerOptions''' должна быть выключена.  
<br>Данная настройка расположена [[file:Settings_gear.png]] => Микросервисы => Messenger => RunDPAMessengerOptions
+
=Создание Telegram-бота=
==Автономный вариант работы сервиса==
 
 
 
 
#Необходимо зарегистрировать собственного Telegram-бота через бота @BotFather, при регистрации нужно выбрать имя бота и получить токен вашего бота.
 
#Необходимо зарегистрировать собственного Telegram-бота через бота @BotFather, при регистрации нужно выбрать имя бота и получить токен вашего бота.
 
#Внести данные своего бота в настройку [[file:Settings_gear.png]] => Микросервисы => Messenger => TelegramBotOptions
 
#Внести данные своего бота в настройку [[file:Settings_gear.png]] => Микросервисы => Messenger => TelegramBotOptions
#На данном этапе требуется подключить пользователей, которые должны получать уведомления к боту. Настройка производится непосредственно из профиля пользователя, кнопка "Подключить Telegram":
+
=Подключение пользователей к рассылке уведомлений=
#*[[file:Tlgr_user_connect.png| 700px ]]
+
На данном этапе требуется подключить пользователей, которые должны получать уведомления к боту. Настройка производится непосредственно из профиля пользователя, кнопка "Подключить Telegram":
#*Далее откроется окно с QR-кодом и веб-ссылкой на Telegram-бота, ссылку можно открыть кликнув на нее, либо отсканировав QR-код. Telegram-бот должен быть активирован тем же пользователем, которому принадлежит профиль пользователя в системе DPA. При успешном подключении у пользователя появится информации о подключении в профиле:
 
#*[[file:Tlgr_user_connect_done.png| 700px ]]
 
 
 
 
 
Для проверки отправки сообщений в настройках Messenger-а нужно перейти на вкладку "Отправить сообщение", где заполнить "Транспорт" chat id пользователя (указан в профиле), а также тему и тест сообщения, после заполнения нажать кнопку "Отправить".
 
 
 
[[file:Test_message.png| 800px ]]
 
 
 
Результат отправки сообщения можно посмотреть на вкладке "История сообщений"
 
 
 
==Как клиент глобального сервиса рассылки сообщений==
 
Для работы мессенджера DPA должна иметь выход в интернет.
 
Настройки мессенджера расположены в разделе
 
 
 
[[file:Settings_gear.png]] => Messenger
 
 
 
1. Подключение системы к глобальному сервису рассылки производится на вкладке подключение, необходимо заполнить поле "Название организации" и отправить запрос:
 
 
 
[[file:Tlgr_connect.png| 700px ]]
 
 
 
Статус запроса изменится на "Ожидает подтверждения".
 
 
 
После подтверждения администратора со стороны компании Экстенсив статус будет изменен на "Подключено"
 
 
 
[[file:Tlgr_connect_done.png| 700px ]]
 
 
 
Данный статус означает, что система подключена к сервису рассылки уведомлений через Telegram, после этого можно приступить к настройке подключения пользователей, для получения уведомлений через Telegram. 
 
 
 
2. Подключение своей учетной записи к Telegram-боту
 
Процедуру подключения необходимо проделать каждому пользователю индивидуально. Настройка производится непосредственно из профиля пользователя, кнопка "Подключить Telegram":
 
  
 
[[file:Tlgr_user_connect.png| 700px ]]
 
[[file:Tlgr_user_connect.png| 700px ]]

Текущая версия на 03:41, 20 января 2022

Данная настройка актуальна, при использовании автономного режима работы микросервиса Messenger, подробнее о настройке режима работы микросервиса в разделе установка.
Внимание! Для работы вашего бота опция RunDPAMessengerOptions должна быть выключена.

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

  1. Необходимо зарегистрировать собственного Telegram-бота через бота @BotFather, при регистрации нужно выбрать имя бота и получить токен вашего бота.
  2. Внести данные своего бота в настройку Settings gear.png => Микросервисы => Messenger => TelegramBotOptions

Подключение пользователей к рассылке уведомлений

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

Tlgr user connect.png

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

Tlgr user connect done.png

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

Test message.png

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