12. [DKSF 488.] Поддержка устройством настраиваемых уведомлений

В web-интерфейсе устройства имеется возможность создания настраиваемых уведомлений (SMS, Email) с произвольным текстом, в который можно включать дополнительно информацию о событии, вызвавшем уведомление. Настраиваемые уведомления работают параллельно со стандартными SMS- и email-уведомлениями с фиксированным текстом. Кроме отправки SMS и email, настраиваемые уведомления позволяют сформировать HTTP GET-запрос, предназначенный дли интеграции NetPing с облачными сервисами. Например, с сервисом автоматизации Zapier.com или ifttt.com, что позволяет выполнить множество действий при получении соответствующих уведомлений. Более детально о том, какие возможности предоставляет Zapier.com, можно изучить по ссылке https://zapier.com/zapbook/webhook/, а iftt.com по ссылке https://ifttt.com/discover.

NetPing не содержит HTTP/HTTPS клиента, и для выполнения запроса он обращается к проприетарному облачному сервису webhook.netping.ru. Он прозрачный, никак не запоминает и не накапливает прошедшую через него информацию. Доступен для любого NetPing-устройства и не требует никакой предварительной авторизации и настройки.

Следует учитывать, что запросы к вызываемому сервису приходят из интернета, поэтому указывать нужно внешний адрес сервиса, а не адрес локальной сети.

Для создания настраиваемого уведомления необходимо зайти на страницу «УВЕДОМЛЕНИЯ» web-интерфейса устройства и нажать на строку «кликните сюда для добавления новых данных» (максимум 16 настраиваемых уведомлений):

Появится окно настройки уведомления со следующими параметрами (на скриншоте ниже изображено уже настроенное уведомление от датчика температуры на канале 5).

SMS-уведомление:

HTTP GET-уведомление:

Еmail-уведомление:

Описание датчиков и событий:

При использовании номера канала «любой канал» рекомендуется использовать подстановку с номером канала, чтобы в уведомлении была информация о том, какой именно датчик вызывал это уведомление.

Датчик	Событие	Описание
Термо 1...8 / любой канал	отказ датчика	Датчик неисправен или не подключен
	ниже нормы	Температура опустилась ниже нормы
	в норме	Температура вернулась в норму
	выше нормы	Температура поднялась выше нормы
Влажность (отн. влажн-ть) 1...4 / любой канал	отказ датчика	Датчик неисправен или не подключен
	ниже нормы	Отн. влажность опустилась ниже нормы
	в норме	Отн. влажность вернулась в норму
	выше нормы	Отн. влажность поднялась выше нормы
Влажность (температура) 1...4 / любой канал	отказ датчика	Датчик неисправен или не подключен
	ниже нормы	Температуры датчика влажности опустились ниже нормы
	в норме	Температуры датчика влажности вернулись в норму
	выше нормы	Температуры датчика влажности поднялись выше нормы
Дым (1W) 1...4 / любой канал	отказ 1W	Адаптер неисправен или не подключен
	ниже нормы	Значение наблюдаемого параметра опустилось ниже нижнего диапазона нормы
	норма	Значение наблюдаемого параметра вошло в диапазон нормы
	выше нормы	Значение наблюдаемого параметра поднялось выше верхней границы диапазона нормы
	вне раб. диапазона	Значение наблюдаемого параметра вышло за пределы рабочего диапазона
Линия IO 1...4 / любой канал	Лог.0	Логический уровень линии переключился в 0
Линия IO 1...4 / любой канал	Лог.1	Логический уровень линии переключился в 1
Реле 1...8 / любой канал	Выкл	Реле выключилось
Реле 1...8 / любой канал	Вкл	Реле включилось
Сторож 1	сброс	Модуль «Сторож» выполнил сброс реле
	приостановка	Работа модуля приостановлена
	возобновление	Работа модуля возобновлена
Сигнал 1...4 / любой канал	активация	Сигнал был активирован логикой. То есть сработало правило логики, выходом которого является «Сигнал 1...4». Подробней о правилах логики и, в частности, сигнале можно прочитать в разделе «10.2. [DKSF 48.5 IU] Как пользоваться модулем «Логика»?»
GSM	SMS не команда	Входящее SMS не является командой
GSM	SMS с неизв. номера	Входящее SMS с неизвестного номера (при условии настройки белых списков номеров). Подробнее о настройке белых списков можно прочитать в разделе «12.2. [DKSF 48.5 IU] Мне нужно прописать номер для отправки SMS-уведомлений. Как это сделать?»

Описание методов уведомления:

Метод уведомления	Описание
SMS	Произвольные SMS-уведомления. В начале текста настраиваемого SMS-уведомления можно задать до четырех адресатов, указав их номера телефонов в квадратных скобках через запятую. Номера указываются в формате «Код_страныКод_оператораНомер_абонента». Между закрывающей квадратной скобкой и текстом сообщения должен быть пробел. Например, «[+79130000001,+79130000002,+79130000003,+79130000004] Хьюстон, у нас проблема!» Если не указывать адресатов, то есть в начале текста отсутствуют квадратные скобки, SMS отправится на номера, заданные в настройках на странице «SMS» web-интерфейса устройства и отмеченные галочкой «Вкл».
HTTP GET	Вызываемый URL стороннего сервиса или облачного приложения. Для отправки этих уведомлений используется схема: NetPing--SNMP TRAP --> webhook.netping.ru–HTTP(URL) --> сервер назначения. Поэтому к серверу назначения нужно обращаться по белому адресу и до него должен быть доступ извне.
email	Отправка email-уведомления происходит на адреса, заданные на странице «EMAIL». В настраиваемом уведомлении возможно задать тему сообщения в поле «Subj» (возможны подстановки) и текст самого email-сообщения. Адресата задать нельзя, сообщения отправляются адресатам, заданным на странице «EMAIL».

В текст настраиваемого уведомления можно включить информацию из ветки NetPing MIB, относящегося к датчику, IO-линии или реле, вызвавшему событие. Формат: {N}, где N — компонент SNMP OID, стоящий перед индексом датчика.

Например, текст SMS-уведомления «{6} - {3} ({4}°C - {5}°C), {2}°C» для датчика температуры включает следующую информацию из ветки NetPing MIB дерева:

Подстановка	Полный OID переменной из NetPing MIB	Имя переменной из NetPing MIB	Описание
{6}	.1.3.6.1.4.1.25728.8800.1.1.6.n	npThermoMemo	Памятка термодатчика, где n — номер датчика 1...8.
{3}	.1.3.6.1.4.1.25728.8800.1.1.3.n	npThermoStatus	Статус термодатчика, где n — номер датчика.
{4}	.1.3.6.1.4.1.25728.8800.1.1.4.n	npThermoLow	Нижняя граница диапазона нормальных значений температуры, где n — номер датчика.
{5}	.1.3.6.1.4.1.25728.8800.1.1.5.n	npThermoHigh	Верхняя граница диапазона нормальных значений температуры, где n — номер датчика.
{2}	.1.3.6.1.4.1.25728.8800.1.1.2.n	npThermoValue	Текущая температура на термодатчике, где n — номер датчика.

Дополнительно.

В тексте SMS в настраиваемых уведомлениях по событиям от GSM (SMS не команда и SMS с неизв. номера) можно использовать следующие подстановки:

{11} — номер телефона отправителя;
{12} — текст SMS в кодировке 1251;
{13} — текст SMS в кодировке UTF8.