Просмотр кода страницы SMS-уведомления 2.0


&nbsp;



== Введение ==

 Модуль отправки&nbsp;SMS-сообщений существенно переработан в версии 2.6.0
 Для предыдущих версий АСУД.SCADA см. статью&nbsp;[[SMS-уведомления|SMS-уведомления]]

Модуль позволяет отправлять сообщения, формируемые примитивами на ситуационном плане SCADA,&nbsp;и&nbsp;фиксируемые Журналом событий АСУД.SCADA:

*в текстовый файл -&nbsp;демонстрационный режим работы модуля 
*на мобильные телефоны с помощью SMS или Push-уведомлений 
*на адреса электронной почты&nbsp; 
*в таблицы&nbsp;Google 
*и т.п. 

Т.е. сообщения формируются '''Примитивами '''SCADA и передаются в Журнал событий SCADA, а также в&nbsp;&nbsp;модуль SMS-уведомлений для их последующей пересылки.
<pre>Примитив --->>  Cообщение  ---->>  Журнал Событий
                           ---->>  SMS-уведомления -->> Обработка -->> Передача адресату
</pre>

'''Внимание!''' Если в настройках примитива установлена опиция "Журнал" - Нет, примитив не будет формировать SMS-уведомления.

Для полноценной&nbsp;работы модуля требуется наличие:&nbsp;

*поключения к сети Интернет 
*4G/3G USB-модема с поддержкой АТ-команд или WEB API 

Для проверки работы модуля в демонстрационном режиме работы&nbsp;(передача сообщений в текстовый файл)&nbsp;никаких дополнительных подключений не требуется.

SMS-cообщения на мобильные телефоны могут отправляться:&nbsp;

*через USB-модем&nbsp; - требуется предоплата за отправленные сообщения; 
*через сервис-провайдера - требуется регистрация и предоплата за отправленные сообщения. 

Модуль позволяет отправлять&nbsp;следующие типы сообщений в зависимости от типа исходного сигнала:&nbsp;

{| align="center" border="1" cellpadding="1" cellspacing="1" style="width: 600px;"
|-
! scope="col" | Тип сигнала
! scope="col" | Тип сообщения
! scope="col" | Комментарий
|-
| style="text-align: center;" | Дискретный
| style="text-align: center;" | Авария / Норма
| style="text-align: center;" | сигнал должен быть визуализирован на ситуационном плане&nbsp;
|-
| style="text-align: center;" | Числовой
| style="text-align: center;" | Авария / Норма
| style="text-align: center;" | сигнал должен быть визуализирован на ситуационном плане&nbsp;с помощью примитива Цифровой индикатор, [[Дополнительные_примитивы|LED-индикатор]]
|-
| style="text-align: center;" | Управления
| style="text-align: center;" | Включение / Выключение
| style="text-align: center;" | сигнал должен быть визуализирован на ситуационном плане&nbsp;с помощью примитива Канал управления
|-
| style="text-align: center;" | Переговорной связи
| style="text-align: center;" | Входящий вызов<br/> ВЫЗОВ / ВЫЗОВ.ОК
| style="text-align: center;" | сигнал должен быть визуализирован на ситуационном плане<br/> (ВЫЗОВ.ОК - завершение вызова с версии 2.7.15)
|-
| style="text-align: center;" | Статус
| style="text-align: center;" | Нет связи / Норма
| style="text-align: center;" | сигнал должен быть визуализирован на ситуационном плане
|-
| style="text-align: center;" | Лифт
| style="text-align: center;" | Авария / Норма
| 
доступно с версии 2.7.15

сигнал должен быть визуализирован на ситуационном плане

|-
| style="text-align: center;" | Служебные
| style="text-align: center;" | Сообщение
| доступно с версии 2.7.15
|}

<br/> Модуль пересылает сообщения указанному получателю в следующем виде:&nbsp;

*Для сигнала Статус 
**ДАТА Сигнал[Устройство]:&nbsp;Нет связи, Адрес   
*Для сигнала Лифт 
**ДАТА Сигнал: [Этаж ЭТАЖ код КодНеисправности] Название неисправности, Адрес   
*Для служебных сообщений 
**ДАТА Сигнал: Название события, Адрес ист. Источник события   
*Для прочих сигналов 
**ДАТА Сигнал: Название события, Адрес   

Например:

*23:29 НОРМА: Двери лифта, ул. Первая д.1 
*23:30 АВАР.: Лифт, ул. Первая д.2 
*23:31&nbsp;АВАР.ЛИФТ: [Этаж 9 код 50987] Привод сообщает об остановке или линия связи CAN, которая не работает, ул. Первая д.1 
*23:32 НОРМА: Двери машинного помещения, ул. Первая д.2 
*23:50 ВКЛ.: Освещение подъезда, ул. Первая д.1 
*00:41 НОРМА[КУН-IP8 - 0]:&nbsp;Нет связи, ул. Первая д.2 

Модуль SMS-уведомлений '''проигнорирует '''входящее сообщение, если было открыто окно настроек&nbsp;Сервис \ Настройки \ SMS-уведомления&nbsp;SCADA.

Для версий до 2.7.15 будут проигнорированы сообщения, если для устройства в конфигураторе ОРС-сервера не заполнены

*поле Адрес; 
*поле Журнал событий \ Название события. 

С версии 2.7.15 пустое поле Адрес будет заполнено значение имени тега, например:&nbsp;DA.[localhost{...}].КУН-IP8 - 0.КСЛ-RS - 0.Лифт - 0.LiftChannel<br/> Пустое поле Название события будут заменено на&nbsp;???.&nbsp;


== Настрока модуля&nbsp; ==

Для настройки модуля следует перейти в режим настройки и выбрать меню Сервис \ Настройки,&nbsp; &nbsp;далее&nbsp; Журналы \ SMS-уведомления

[[File:SCADASMS.PNG|center|450px|SCADASMS.PNG]]

Далее следует:&nbsp;

#создать один или несколько фильтров (или правил)&nbsp; обработки входящих сообщений 
#выбрать Провайдера передачи сообщений 

'''Внимание!'''

*Сообщения передаются только на один выбранный провайдер. 
*При смене провайдера - набор правил не удаляется / изменяется. 
*Если провайдер не выбран - сообщения отправляться не будут 
*Должно быть создано минимум 1 правило.

== Фильтры&nbsp;обработки сообщений ==

Для работы модуля следует создать один&nbsp;или несколько фильтров обработки входящих сообщений.&nbsp;

Для создания фильтра следует выполнить клик правой кнопкой мыши, выбрать Добавить.

Далее настроить фильтр:

*Название&nbsp; - просто имя фильтра (желательно уникальное) 
*Сообщение -&nbsp; шаблон входящего сообщения&nbsp; 
**символ звездочка *&nbsp;- любое сообщение удовлетворяет фильтру 
**лифт - в сообщении должно быть слово "лифт", например:&nbsp;&nbsp; 
***"Авария '''лифта'''"'''&nbsp;&nbsp;'''- удовлетворяет фильтру 
***"Открытие двери" - нет   
**лифт; Планерная - в сообщении должны&nbsp;быть слова и "лифт" и "Планерная", например: 
***"Неисправность лифта, ул. Первая"&nbsp; - нет 
***"Неисправность '''лифта''', ул. '''Планерная'''"'''&nbsp;'''- удовлетворяет правилу&nbsp;     
*Получатель сообщения - телефон (11 цифр), E-mail адрес или другой идентификатор устройства&nbsp;&nbsp;в заивисимости от выбранного Провайдера<br/> (подробнее см. далее в описании работы конкретного провайдера) 
**если Получатель не указан (пустой) - сообщение будет отброшено (проигнорировано)   
*Тип сигнала - тип сигнала, сформировавшего сообщение 
*Уведомить о переходе в Норма - сформировать сообщение при переходе сигнала в нормальное состояние 
**норма - для дискретного сигнала&nbsp; 
**выкл. - для канала управления 
**На связи - для канала статуса   
*Отключить&nbsp;&nbsp;правило&nbsp; - игнорировать правило (правило не удаляется, но не участвует в обработке) 

'''Внимание! Важно!'''<br/> Будьте внимательны при создании правила&nbsp;'''для сигналов типа Статус''' (особенно при платной отправке SMS-сообщений).<br/> Т.к. в случае выхода из строя, например: USB-пульта сообщение "Нет связи" будет сформировано также для всех подключенных к USB-Пульту концентраторов.<br/> Обратите внимание, что в сообщении "Нет связи", например:&nbsp; "00:43 АВАР.[КУН-IP8 - 0]: Нет связи, ул. Первая д.1"&nbsp; - в квадратных скобках указывается тип устройства (из адресного пространства ОРС-сервера), с которым отсутствует связь, что можно использовать при настройке поля "Сообщение" в правиле обработки сообщений.<br/> Кроме того, "Нет связи" будет сформировано при запуске Конфигуратора ОРС-сервера без предварительной закрытия программы SCADA&nbsp;

== Порядок обработки входящих сообщений ==

Входящие сообщения обрабытываются в следующей последовательности&nbsp;

*Если сообщение удовлетворяет фильтру - ''дальнейшая проверка прекращается''. 
*Если сообщение удовлетворяет фильтру, но Получатель сообщения в правиле не указан (пустой)&nbsp;- ''сообщение будет отброшено''. 
*Если сообщение не удовлетворяет ни одному из филтров - ''сообщение будет отброшено''. 

Созданные фильтры обрабатываются последовательно (вы можете поменять порядок следования, выбрав фильтр&nbsp;и, нажав правой кнопкой мыши).

Сообщение, которое удовлетвеоряет хотя бы одному фильтру,&nbsp;сразу отправляется выбранному провайдеру для передачи.&nbsp;

Как правило,&nbsp;&nbsp;один сигнал - формирует одно сообщение, например: одно событие&nbsp; - одна SMS.

Для некоторых провайдеров, например: E-mail, сообщения&nbsp;могут объединяться в группы при отправке.&nbsp;<br/> Группа формируется из последовательно возникших сообщений в течение времения 5 с<br/> (интервал может быть изменен в конфигурационном файле settings/smsterminal.conf, параметр SleepTimeBeforeSend).

Если при отправке сообщения провайдер получил ошибку - сообщение будет отброшено.<br/> Если при отправке сообщения провайдер не доступен (точнее не доступен сервис, с которым работает провайдер): нет связи (подключения), проблемы с сетью и т.п., то&nbsp;программа&nbsp;&nbsp;повторит отправку сообщения до 10&nbsp;раз&nbsp;через каждые 30 секунд. Если провайдер продолжит быть недоступным, сообщение будет отброшено.&nbsp;

Ошибки отправки сообщений фиксируются в оперативном журнале событий SCADA.

[[File:Smsterminal oper error.PNG|center|Smsterminal oper error.PNG]]

== Провайдеры передачи сообщений ==

=== Текстовый файл ===

Это демонстрационный провайдер. Сообщения просто пишутся в файл log \ smsmessage_DDMMYY.txt

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

Провайдер может обрабатывает сообщения группами по 2 сообщения.

Поле Получатель в фильтре сообщений&nbsp; - должно содержать:

*валидный мобильный номер (11 цифр, например: 79011234567), 
*или валидный адрес email (например: mail@mail.com) 

=== АТ-SMS модем&nbsp; ===

Отправка SMS-сообщений через USB-модем с поддержкой АТ-команд (см. документацию на модем)

Признаком того, что модем поддерживает работу с AT-командами, является появление в системе COM-порта при подключении модема.&nbsp;

Провайдер обрабатывает по 1&nbsp;сообщению.

Для настройки USB-модема, следует нажать кнопкку Настроить.

Пример настройки модемов марки ZTE см. в статье&nbsp;[[SMS-уведомления|SMS-уведомления]]

=== SMSЦентр SMS ===

Отправка SMS-сообщений через сервис-провайдера&nbsp;[https://www.smsc.ru https://www.smsc.ru]

Требуется подключение к Интернету.&nbsp; Отправка сообщений - платная (тарифы на отправку см. на сайте сервис-провайдера).

Для настройки требуется несложная предварительная регистрация на сайте сервис-провайдера.

В случае отправки сервисных SMS-сообщений, в общем случае не требуется заключение дополнительных договоров с сервис-провайдером.

Провайдер обрабатывает по 1&nbsp;сообщению.

=== SMSЦентр Email ===

Отправка сообщений электронной почты&nbsp;через сервис-провайдера&nbsp;[https://www.smsc.ru https://www.smsc.ru]

Требуется подключение к Интернету.&nbsp; Отправка сообщений - платная (тарифы на отправку см. на сайте сервис-провайдера).

Для настройки требуется предварительная регистрация на сайте сервис-провайдера. А также существующий адрес электронной почты, от имени которого будет осуществляться отправка сервисных сообщений.

В случае отправки сервисных сообщений, в общем случае не требуется заключение дополнительных договоров с сервис-провайдером.

Провайдер обрабатывает сообщения группами по 10&nbsp;сообщений.

=== Email ===

Отправка сообщений электронной почты&nbsp;через корпоративный или бесплатный&nbsp;&nbsp;Почтовый сервер.

Провайдер обрабатывает сообщения группами по 10&nbsp;сообщений.

В качестве бесплатного Почтового сервера, вы можете использовать например&nbsp;[http://www.mail.ru http://www.mail.ru]&nbsp; Параметры настройки см. [https://help.mail.ru/mail-help/mailer/popsmtp здесь]&nbsp;

[[File:SCADASMS EM.PNG|center|350px|SCADASMS EM.PNG]]

&nbsp;

Если почтовый сервер mail.ru не позволяет отправлять сообщения на ваш e-mail, вы можете создать почтовый ящий на самом сервисе и отправлять сообщения на него.

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

Адрес получателя сообщений в рабочем режиме будет указываться при формировании Правил обработки сообщений.

=== Pushover ===

[https://pushover.net Pushover ]&nbsp;позволяет легко получать PUSH-уведомления в режиме реального времени на Android, iPhone, iPad и ПК (Android Wear и Apple Watch).&nbsp;

Провайдер обрабатывает сообщения группами по 10&nbsp;сообщений.

Требуется подключение АРМ к Интернету.&nbsp; Требуется установка приложения на мобильный телефон или ПК.&nbsp;

Вы можете воспользоваться бесплатным тестовым 7-дневным периодом после [https://pushover.net регистрации на сайте].&nbsp;&nbsp;

По окончании тестового периода, плата за пользование приложением составляет -&nbsp;[https://pushover.net/pricing 5$ (единовоременно,&nbsp; Individual pricing)]. Число отправляемых PUSH-уведомлений&nbsp;- до 7500 в месяц.

После регистарации вы получите&nbsp;Pushover user key&nbsp; (UserToken). Также вам будет предложено задать имя вашего устройства&nbsp; - можете указать любое.&nbsp;

Далее следует в личном кабине сформировать (бесплатно)&nbsp; новое приложение (API Token). Если вы настраиваете несколько АРМ SCADA, вы можете использовать для них один и тот же API Token.

Указанные регистрационные данные внести в окно настройки провайдера&nbsp;

[[File:Pushover.PNG|center|350px|Pushover.PNG]]

*AppToken - API Token 
*UserToken -&nbsp;Pushover user key 
*Заголовок&nbsp; - Заголовок сообщений, отпавляемых через провайдера 

Остаток сообщений - это число сообщений, которое может быть отправлено с данным AppToken до конца текущего месяца.&nbsp;

Если вы хотите, чтобы уведомления получали два (или более) человека одновременного, следует создать Группу в настройках личного кабинета на сайте. И в качестве UserToken - указывать идентификатор созданной группы.

'''Особенности настройки правил при использовании провайдера Pushover'''

В поле "Получатель"&nbsp;сообщения при настройке фильтров сообщений&nbsp;следует указывать none - тогда сообщение будет доставлено на все зарегистрированные устройства пользователя / группы.

Или указывать устройства через запятую, например:&nbsp; &nbsp;iphone1, nexus, andr17

[[File:Smsterminal msg none.PNG|center|Smsterminal msg none.PNG]]

=== Таблицы Google ===

Позволяет записывать сообщения в указанную таблицу Google.

Провайдер обрабатывает сообщения группами по 10&nbsp;сообщений.

Сообщения&nbsp;будут просто дописываться в новые&nbsp;строки указанной таблицы.

Не требуется никакой оплаты (в случае если число сообщений не превышает установленный лимит сообщений&nbsp;указанный далее).

==== Настройка таблицы Google ====

Для возможности работы с провайдером следует:&nbsp;

*Создать учетную запись электронной почты&nbsp;на Gmail (если отсутствует). 
*Зайти&nbsp;под аккаунтом Gmail на&nbsp;[https://console.developers.google.com/project Google Developers Console] и создать&nbsp;новый проект (с любым названием). 
*Слева вверху выберать&nbsp;раздел меню API и сервисы. 
*Включить для проекта&nbsp; Drive API и Sheets API (Меню API и сервисы \ Библиотека). 
*Создать сервисный аккаунт и сохранить сервисный ключ. 
*Создать&nbsp;[https://drive.google.com таблицу Google]. 
*Разрешить сервисному аккаунту доступ к таблице. 

[[File:Google api5.PNG|center|200px|Google api5.PNG]]

&nbsp;

[[File:Google api1.PNG|center|450px|Google api1.PNG]]Название сервсисного аккаунта укажите любое, тип ключа - JSON.

[[File:Google api2.PNG|center|450px|Google api2.PNG]]

Выберите роль - Владелец.<br/> [[File:Google api3.PNG|center|450px|Google api3.PNG]]

Создайте сервисный аккаунт,&nbsp; нажмите&nbsp;Создать и&nbsp;и сохраните ключ в папке ..\Scada\settings

Ключ необходимо переименовать в файл ..\Scada\settings\'''gsheet.json'''

Далее создаем новую&nbsp;[https://drive.google.com таблицу Google], содержащую один&nbsp;или несколько листов.

[[File:Google api4.PNG|center|450px|Google api4.PNG]]

Имя файла таблицы может быть любым. В примере указано: ASUDTable

Необходимо запомнить:&nbsp;

*идентификатор таблицы (SheetId), который выделен в адресной строке; 
*имя листа, в который будет записываься данные. 
*добавить в первой строке таблицы названия колонок, как указано выше 

Далее необходимо нажать кнопку Настройки доступа

[[File:Google api6.PNG|center|300px|Google api6.PNG]]

И добавить адрес электронной почты сервисного аккаунта к списку разршенных людей (сняв галочку "Оповестить пользователей")

[[File:Google api7.PNG|center|350px|Google api7.PNG]]

&nbsp;

&nbsp;

==== Настройка провайдера ====

В окне настройки провайдера следует указать идентификатор таблицы и название листа.

[[File:Google api8.PNG|center|450px|Google api8.PNG]]Для проверки корректности ввода параметров, можно отправить Тестовое сообщение - просто нажмите кнопку Отправить.&nbsp; Если все данные введны правильно, вы получите сообщение "Успешно отправлено", а в таблицу будет добавлена строка со значениями в четырых столбцах&nbsp;&nbsp;А1, B1, C1, D1

Пример отображения данных в таблице приведен ниже.

[[File:Google api9.PNG|center|450px|Google api9.PNG]]

&nbsp;

'''Особенности настройки правил при использовании провайдера&nbsp;'''

В поле "Получатель"&nbsp;сообщения при настройке фильтров сообщений&nbsp;следует указывать '''none.'''

==== Ограничения ====

Существующие ограничения:&nbsp; max 100 запросов к Google API за 100 секунд для проекта.

Вы можете использовать один и тот же сервисный ключ (файл settings\gsheet.json)&nbsp;на нескольких АРМ (указывая при это в настроках провайдера - разные таблицы или разные листы одной таблицы).

Однако если число сообщений велико и вы превышаете бесплатный лимит,&nbsp;&nbsp;то вам может потребоваться создавать отдельный проект под каждый АРМ.

&nbsp;

=== HTTP(S) JSON ===
<pre>Доступно с версии АСУД.SCADA 2.7.5</pre>

Провайдер позволяет отправлять&nbsp;уведомления на сторонний WEB-сервер по протоколу HTTP(S).&nbsp;

Провайдер обрабатывает сообщения группами по 10&nbsp;сообщений.

Сообщение отправляются в формате JSON.

[[File:Smsterminal msg http.PNG|center|Smsterminal msg http.PNG]]

В окне настройки провайдера следует указать:

*Адрес сервера - URL-адрес, на который будет отправлено&nbsp;JSON-сообщение 
*Заголовок - произвольный идентификатор, который будет указан в JSON-сообщении 

Вы можете отправить на сервер полный адресный список точек диспетчеризации. Для этого следует нажать кнопку Отправить адресный список.&nbsp;

Для отправки тестового сообщения на сервер - нажмите Отправить.

При настройке правил&nbsp;фильтров сообщений, следует в поле Получитель указывать none.

[[File:Smsterminal msg none.PNG|center|Smsterminal msg none.PNG]]

Примеры JSON-сообщений

1. Адресный список точек диспетчеризации&nbsp;
<pre>{
"ObjectID":"SCADA",   
"Points":
[{
"ItemID":"DA.[localhost{188D08EC-72CB-425B-8EA8-EE2308736440}].КУН-IP8 - 0.DiscretChannel06", 
"ItemType":3000,
"JournalName":"Корпус устройства",
"JournalCategory":"Охрана",
"Address":"777"
}]
}</pre>

где:&nbsp;

*ObjectID -&nbsp;заголовок (id-объекта) 
*Points -&nbsp; массив точек диспетчеризации&nbsp; 
*ItemID - ID точки диспетчеризации&nbsp; 
*ItemType - тип точки учета (обратитесь в тех.поддержку за разъяснениями) 
*JournalName - название сигнала 
*JournalCategory - категория сигнала 
*Address - адрес точки диспетчеризации&nbsp; 

2. Информационное сообщение
<pre>{
"ObjectID":"SCADA",
"Messages":
[{
"ItemID":"DA.[localhost{188D08EC-72CB-425B-8EA8-EE2308736440}].КУН-IP8 - 0.DiscretChannel06",
"Time":"11.01.22 17:30",
"Address":" 777",
"Event":"АВАР.",
"JournalName":" Корпус устройства"
}]
}</pre>

где:&nbsp;

*ObjectID -&nbsp;заголовок (id-объекта) 
*Messages&nbsp;-&nbsp; массив сообщений 
*ItemID - ID точки диспетчеризации&nbsp; 
*Time - время события 
*Address - адрес точки диспетчеризации&nbsp; 
*Event - событие 
*JournalName -&nbsp;название сигнала 

3. Тестовое сообщение
<pre>{
"ObjectID":"SCADA",
"Test":"Test message Тестовое сообщение 11.01.2022 17:33:37"
}</pre>

&nbsp;












=== Telegram ===
<pre>АСУД.SCADA 2.7.20.2 
+ Коррекция работы /lift
АСУД.SCADA 2.7.19 
+ Не отображался ID группы, при настройке бота для работы с групой / каналом
АСУД.SCADA 2.7.18 
+ BotAPI версия 1.3
АСУД.SCADA 2.7.17 (upd 1)
+ BotAPI версия 1.2 
+ сообщение о запуске / останове SCADA
+ дополнительная справочная информация
АСУД.SCADA 2.7.16
+ BotAPI версия 1.1
+ отображение любого вида карты
+ возможность отображения состояния сигналов в группе
АСУД.SCADA 2.7.15
+ возможность отправлять сообщения боту добавленному в группу, канал
+ поддержка команд пользователя 
Доступно с версии АСУД.SCADA 2.7.14 (для Windows 8/10)</pre>

Провайдер позволяет отправлять&nbsp;уведомления в созданный вами Telegram Bot.

Предполагается, что&nbsp;[[АРМ-диспетчера|АРМ-диспетчера]]&nbsp;подключен к сети Интернет.

Провайдер обрабатывает сообщения группами.

Предварительно вы должны создать&nbsp;Telegram Bot, в который будут приходить сообщения.

==== Создание Бота ====

Для создания бота выполните следующие шаги:

*Запустите новый чат с ботом&nbsp;[https://t.me/botfather @BotFather]&nbsp;в Telegram 
*Отправьте команду&nbsp;[https://github.com/GabrielTrigo/telegram-bot-delphi/blob/main /newbot] 
*Выберите название вашего бота, которые будет отображаться в заголовке чата (непринципиально какое) 
*Выберите уникальное имя бота,&nbsp;&nbsp;оно должно оканчиваться на "_bot", например: ods12345_bot 
*Скопируйте уникальный идентификатор созданного бота, который следует указать в настройках далее 

Идентификатор бота выглядит следующим образом:
<pre>НаборЧисел&nbsp;: БуквенноЦифроваяКомбинация</pre>

В версии 2.7.14&nbsp; бот имел следующие ограничения:&nbsp;

*взаимодействует только с одним пользователем 
*не обрабатывает команды пользователя, а только отправляет сообщения 
*не поддерживается работа бота в канале / группе 

Замечания:

*По-умолчанию боты в Telegram являются публичными, т.е. найти созданный вами бот по имени сможет любой пользователь Telegram.<br/> Однако взаимодействовать бот будет только с пользователем, идентификатор которого вы укажите в настройках 
*Если количество сообщений, которые будет формироваться [[АРМ-диспетчера|АРМ-диспетчера]]&nbsp;небольшое,&nbsp;вы можете использовать одного бота на нескольких [[АРМ-диспетчера|АРМ-диспетчера]], или создавать отдельного бота для каждого&nbsp;[[АРМ-диспетчера|АРМ-диспетчера]] 
**Telegram ограничивает число отправляемых ботом пользователю&nbsp;сообщений: не более 1-го сообщения в секунду.   

==== Настройка провайдера ====

После создания бота, добавьте его в Telegram на устройстве пользователя, который&nbsp;будет&nbsp;получать сообщения.

Если вы хотите чтобы сообщения получали несколько&nbsp; пользователей, вам следует:

*создать канал или группу 
*добавить туда пользователей 
*добавить туда созданного бота&nbsp; 
*дать&nbsp;боту права на чтение сообщений в&nbsp;группе/чате, если хотите, чтобы бот отвечал на команды. 

Для этого в&nbsp;меню BotFather выбираем /edit your bots (если ботов несколько, выбираем нужный), выбираем Bot Settings&nbsp;/ Group Privacy, выбираем Отключить. После этого в свойствах бота в группе будет указано:
<pre>ИмяБота
имеет доступ к сообщениям</pre>

Далее откройте окно настроек провайдера Telegram в SCADA

[[File:Sms telegram.PNG|center|350px|Sms telegram.PNG]]В окне настройки провайдера следует указать:

*BotID - идентификатор бота, полученный при регистрации&nbsp; 
*UserID - идентификатор пользователя, которому будут приходить сообщения 
**если это одиночный пользователь - его ID это положительное число 
**если это группа / канал - ID отрицательное число.   
*Заголовок - произвольный идентификатор диспетчерской (не обязательный), который будет указан в отправляемых пользователю сообщениях 

Проверить правильность указания BotID, можно нажав, Проверить.

В случае если все указано правильно, вы увидите примерно следующее сообщение.

[[File:Sms telegram bot1.PNG|center|upright|Sms telegram bot1.PNG]]

Далее,&nbsp;для того чтобы определить идентификатор пользователя (группы или канала), пользователь должен отправить боту сообщение с текстом MyID. После этого следует нажать кнопку Узнать.

После указания идентификатора,&nbsp; для отправки тестового сообщения пользователю (группе / каналу) - нажмите Отправить.

При настройке правил&nbsp;фильтров сообщений, следует в поле Получитель указывать none.

[[File:Smsterminal msg none.PNG|center|350px|Smsterminal msg none.PNG]]

&nbsp;

==== Команды пользователя ====

При работающей SCADA,&nbsp;&nbsp;Telegram bot способен отвечать на команды пользователя.

Для отправки команды, следует написать команду после символа /, например:&nbsp;
<pre>/help</pre>

Поддерживаются следующие команды:&nbsp;

BOT версия 1.3&nbsp;список команд:<br/> /help - справка<br/> /date - текущая дата<br/> /db_info&nbsp;- информация о числе приборов учета с проблемами в опросе&nbsp;(подробнее см. далее)<br/> /db_kir&nbsp;- отображение числа импульсов по каналам [[КИР-16_исп._TL-RS|КИР&nbsp;&nbsp;]](подробнее см. далее)<br/> /db_pu - информация о показаниях указанного прибора учета<br/> /info - информация о SCADA<br/> /j_alert - активные сигналы<br/> /j_alert_all - события сегодня<br/> /j_kio - информация о состоянии подключенных КИО<br/> /j_kunip - информация о состоянии подключенных концентраторов КУН-IP<br/> /j_soft -&nbsp; информация о запуске программы&nbsp;SCADA<br/> /j_voice - журнал переговоров диспетчера<br/> /j_voice_rec&nbsp;- записи&nbsp;переговоров диспетчера<br/> /lift - информация о состоянии лифта<br/> /group - отображение значения сигналов группы&nbsp;(подробнее см. далее)<br/> /ping - ping указанного IP со стороны АРМ-диспетчера<br/> /screenshot - изображение текущего активного&nbsp;экрана диспетчера<br/> /screen - изображение выбранного вида из иерархии видов карты (подробнее см. далее)

Вы можете получить дополнительную справочную информацию по команде, введя&nbsp;
<pre>/help команда
, например:
/help lift
</pre>

'''Замечание''':<br/> если боту разрешено чтение всех сообщений в чате / группе, вы можете писать команду не адресуя ее боту, т.е. писать просто: /help<br/> в противном случае следует писать команду и имя бота, например: /help @mybot

==== Команда DB_INFO ====

Команда активна, если на объекте осуществляется опрос приборов учета.&nbsp;

Команда отображает данные о числе приборов учета с оценкой опроса&nbsp; = 0.
<pre>/db_info</pre>

==== Команда DB_PU ====

Команда активна, если на объекте осуществляется опрос приборов учета.&nbsp;

Команда отображает последние показания прибора учета с указанным серийным номером.
<pre>/db_pu 5678 или /db_pu5678</pre>

Вы можете вводить серийный номер полностью или только последние цифры

==== Команда DB_KIR ====

Команда активна, если на объекте осуществляется опрос приборов учета.&nbsp;

Команда отображает&nbsp;число&nbsp;импульсов по каналам указанного&nbsp;[[КИР-16_исп._TL-RS|КИР]]

Команда имеет смысл для КИР, работающий по RS-интерфейсу, т.к. способна выполнять приоритетный опрос указанного КИР вне очередности.&nbsp;&nbsp;

Команда может быть удобна при выполнении пуско-наладочных работ, при проливики приборов учета.
<pre>/db_kir901 или /db_kir 901</pre>

где 901 - номер концентратора в БД.

В ответ вы получите до 5 уведомлений с интервалом в 30 с. об измении состояния имп. входов концентратора.&nbsp;

==== Команда J_VIOCE_REC ====

Команда позволяет прослушать выбранный файл переговоров диспетчера за текущий сутки.

Следует обратить внимание, что Telegram может корректно проигрывать файлы следующих типов:

*несжатый wav 
*mp3 

По-умолчанию, SCADA использует кодек gsm-wav.

Если вы планируете использовать данный функционал, настройте в SCADA (в меню Сервис \ Настройки \ Журналы \ Журнал ПГС) использование кодека, например: mp3.

==== Команда GROUP ====

Для распределения сигналов по группам (и в дальнейшем использовании команды /group) следует предварительно создаться список групп в конфигурационном файле&nbsp;

settings /&nbsp;telegram_group.ini&nbsp;

Файл следует перенести в папку&nbsp; settings&nbsp; из&nbsp;папки settings / templ

Пример файла (кодировка ANSI):&nbsp;
<pre>[Вызовы]
DA.[localhost{...}].КУН-IP8 - 0.VoiceChannel01=
DA.[localhost{...}].КУН-IP8 - 0.Temperature01=
[Двери]
DA.[localhost{...}].КУН-IP8 - 0.DiscretChannel01=
[Лифты]
DA.[localhost{...}].КУН-IP8 - 0.КСЛ-RS - 0.Лифт - 0.LiftChannel=</pre>

В скобках указывается название группы, далее перечень сигналов, оканчивающихся знаком (=)<br/> Число групп не ограничено, число сигналов в группе не ограничено.<br/> Конфигурационный файл перечитывается при запуске программы SCADA.

==== Команда SCREEN ====

Следует отметить, что при выполнии команды на экране АРМ будет открыт выбранный подвид.<br/> Поэтому команду логично использовать на АРМ, за которым в данный момент не находится диспетчер.&nbsp;

=== 4G LTE Модем E3372 ===
<pre>Доступно с версии АСУД.SCADA 2.7.10</pre>

Отправка SMS-сообщений через 4G USB-модем E3372H-153 (ZTE ZXIC MODEM), работающий в режиме HiLink.

Модем опредяляется в системе, как устройство:

*USB\VID_19D2&PID_0548&REV_0100, USB\VID_19D2&PID_0548 

Модем следует предварительно настроить:

*При первом включении он определится,&nbsp;как CD-ROM, с которого необходимо установить ПО 4G Mobile hotspot 
*Далее следует отключить CD-ROM через подключенные USB-устройства 
*Модем должен определиться, как сетевое устройство и в системе появится новая сеть 192.168.8.0 / 24 
*Заходим на WEB-страницу&nbsp; 
*Если используем модем только для отправки SMS, отключаем подключение к Интернету (устанавливаем Мобильное подключение / Мобильная сеть&nbsp;- вручную) 

В ПО USB-модема фактически не настраивается, можно лишь проверить корректность его подключения. Для этого следует нажать кнопку Настроить.

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

[[File:Sms e3372 nastr.PNG|center|350px|Sms e3372 nastr.PNG]]Здесь же, можно отправить тестовое сообщение на указанный номер телефона.

Провайдер обрабатывает по 1&nbsp;сообщению.

'''Техническая информация по отправке сообщений'''

Несколько слов о том, как работает отправка сообщений.

Многие модемы в режиме HiLink поддерживают набор WEB API,&nbsp;информацию&nbsp;о котором можно посмотреть [https://github.com/chanakalin/hilinkapi здесь]

Однако модем, который попался нам, данный набор&nbsp;API не поддерживал

[[File:Sms e3372.PNG|center|350px|Sms e3372.PNG]]

Указанная версия устройства позволяет получить информацию о состоянии и отправить SMS-сообщения через следующие HTTP-запросы.

''Первоначальная авторизация &nbsp;- метод POST''
<pre>http://192.168.8.1/reqproc/proc_post</pre>

Параметры запроса:<br/> isTest=false<br/> goformId=LOGIN<br/> password=YWRtaW4=

''Информация о состоянии подключения к мобильной сети - метод GET''

Запрос:&nbsp;
<pre>http://192.168.8.1/reqproc/proc_get?isTest=false&cmd=GOFORM_GET_CRRRSP_INFO&_=%u</pre>

, где&nbsp;%u - время в формате&nbsp;Unix Timestamp

Ответ:&nbsp;
<pre>{"rssi":"-78.0","sinr":"1.1","rsrq":"-9.5","cellid":"1795428097","rsrp":"-102"}</pre>

О''тправка SMS сообщения&nbsp;- метод POST''
<pre>http://192.168.8.1/reqproc/proc_post</pre>

Параметры запроса:<br/> isTest=false<br/> goformId=SEND_SMS<br/> notCallback=true<br/> Number=+79011234567<br/> sms_time=YY;MM;DD;HH;MM;SS;+3<br/> MessageBody=Text<br/> ID=-1<br/> encode_type=UNICODE

, где:

sms_time - время в UTC<br/> MessageBody - должен быть указан в кодировке&nbsp;encode_type: UNICODE&nbsp;или GSM7_default.

Ответ
<pre>{"result":"success"}
</pre>

=== 4G LTE Модем JOYS W03 ===
<pre>Доступно в обновлении для версии АСУД.SCADA 2.7.14 </pre>

Отправка SMS-сообщений через 4G USB-модем JOY'S W03.

Работа с модемом проверена в Windows 7, 10.

Модем не требует установки дополнительного программного обеспечения&nbsp;и не определяется, как USB-диск.

После подключения к USB-порту, модем определяется в ситеме как сетевой NDIS интерфейс и в системе появляется новая сеть 192.168.0.1&nbsp;/ 24. Дополнительно появляется несколько Mobile devices, драйверов для которых нет.&nbsp;

[[File:Modem joys.PNG|center|upright|Modem joys.PNG]]

Модем следует предварительно настроить:

*Заходим на WEB-страницу&nbsp; 192.168.0.1&nbsp; admin / admin&nbsp; 
*Если используем модем только для отправки SMS, отключаем подключение к Интернету, WiFi-роутер 
*Если уже использовалась&nbsp;сеть 192.168.0.1 / 24, следует изменить сетевые настройки в модеме. 

Для настройки модема в&nbsp; ПО АСУД.SCADA&nbsp;следует нажать кнопку Настроить.

[[File:Modem joys sett.PNG|center|upright|Modem joys sett.PNG]]По необходимости следует изменить:

*IP-адрес модема 
*Логин 
*Пароль 

Здесь же, можно отправить тестовое сообщение на указанный номер телефона (без знака +).

Провайдер обрабатывает по 1&nbsp;сообщению.

'''Техническая информация по отправке сообщений'''

Несколько слов о том, как работает отправка сообщений.

Модемы типа JOY'S позволяют использовать для отправки SMS сообщений HTTP-API.

Общение с модемом происходит по следущему алгоритмы:

*запрос данных авторизации&nbsp; 
*авторизация&nbsp; 
*отправка сообщения 

''Запрос&nbsp;авторизации&nbsp;- метод GET''
<pre>http://192.168.0.1/login.cgi?_%u
</pre>

, где&nbsp;%u - время в формате&nbsp;Unix Timestamp

О''тправка SMS сообщения&nbsp;- метод POST''
<pre>http://192.168.0.1/xml_action.cgi?method=set&module=duster&file=message</pre>

, где в контенте запроса передается xml вида:
<pre> <?xml version="1.0" encoding="US-ASCII">
  <RGW>
  <message>
  <flag>
  <message_flag>SEND_SMS</message_flag>
  <sms_cmd>4</sms_cmd>
  </flag>
  <send_save_message>
  <contacts>PHONE</contacts>
  <content>TEXT</content>
  <encode_type>UNICODE</encode_type>
  <sms_time>
   FormatDateTime ('yy,mm,dd,hh,nn,ss,',Now) + '%2B3</sms_time>
  </send_save_message>
  </message>
  </RGW></pre>

[[Category:SCADA]]