Уведомления: различия между версиями

Материал из WiKi - UserSide
мНет описания правки
Нет описания правки
 
(не показано 7 промежуточных версий 3 участников)
Строка 1: Строка 1:
[[Notifications|en]] | [[Уведомления|ru]]
В разделе "Настройка" => "Уведомления" собран функционал управления средствами доставки разнообразных уведомлений.
В разделе "Настройка" => "Уведомления" собран функционал управления средствами доставки разнообразных уведомлений.


Строка 7: Строка 9:
== Электронная почта ==
== Электронная почта ==


[[Файл:20170701-21.PNG|thumb|800px|center]]
[[Файл:Wi-Ki 605.png|thumb|800px|center]]


Вы можете выбрать один из двух видов транспорта:
Вы можете выбрать один из двух видов транспорта:
Строка 24: Строка 26:
== SMS ==
== SMS ==


[[Файл:20170701-22.PNG|thumb|800px|center]]
[[Файл:Wi-Ki106.png|thumb|800px|center]]


== Telegram ==
== Telegram ==
Строка 30: Строка 32:
''(Начиная с версии 3.15)''
''(Начиная с версии 3.15)''


В меню: Настройка - Уведомления - Messenger необходимо выполнить следующие настройки.
В меню: "Настройка" => "Уведомления" => "Messenger" необходимо выполнить следующие настройки.
 
[[Файл:Telegram-setup.png|центр]]


1. '''Служба''' - Telegram
1. '''Служба''' - Telegram


2. '''Bot token''' - указать API-токен вашего бота, через которого будет осуществляться отправка. Чтобы создать Telegram-бота и/или получить его API-токен, необходимо написать боту <code>@BotFather</code> https://t.me/BotFather и выбрать в меню создание нового бота, если у вас его еще нет, после чего через меню запросите его API-токен.
2. '''Bot token''' - указать API-токен вашего бота, через которого будет осуществляться отправка. Чтобы создать Telegram-бота и/или получить его API-токен, необходимо написать боту <code>@BotFather</code> https://t.me/BotFather и выбрать в меню создание нового бота, если у вас его еще нет, после чего через меню запросите его API-токен. API-токен выглядит примерно следующим образом: <code>123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11</code>


3. '''URI прокси-сервера''' - необязательно - укажите URI прокси, если используете, вместе с протоколом и номером порта. Например, <code>socks://telegram.proxy</code> или <code>tcp://telegram.proxy:8125</code> и т.п.
3. '''URI прокси-сервера''' - необязательно - укажите URI прокси, если используете, вместе с протоколом и номером порта. Например, <code>socks://telegram.proxy</code> или <code>tcp://telegram.proxy:8125</code> и т.п.


4. '''Parse Mode''' - необязательно - укажите режим обработки текста сообщения. Можно выбрать между режимами "простой текст" и режимами "Markdown", "HTML". Подробнее в документации: https://core.telegram.org/bots/api#formatting-options
4. '''Parse Mode''' - необязательно - укажите режим обработки текста сообщения. Можно выбрать между режимами "простой текст" и режимами "Markdown", "HTML". Подробнее в документации: https://core.telegram.org/bots/api#formatting-options
[[Файл:Notifications-messenger-telegram.jpg]]


Телеграм бот сможет отправлять сообщения пользователям телеграм только после того, как пользователь телеграм запустит бота. Для этого нужно открыть чат с ботом, затем нажать "Запустить" внизу чата, после чего написать что угодно боту, например, <code>/start</code>. Далее необходимо узнать chat-id пользователя Телеграм, которому бот должен будет отправлять сообщения, и внести его в данные пользователя Userside.
Телеграм бот сможет отправлять сообщения пользователям телеграм только после того, как пользователь телеграм запустит бота. Для этого нужно открыть чат с ботом, затем нажать "Запустить" внизу чата, после чего написать что угодно боту, например, <code>/start</code>. Далее необходимо узнать chat-id пользователя Телеграм, которому бот должен будет отправлять сообщения, и внести его в данные пользователя Userside.
Строка 46: Строка 48:
Для каждого оператора системы можно указать его chat-id — это уникальный идентификатор пользователя в пределах сети Телеграм. Самый быстрый способ узнать свой chat-id - написать боту <code>@JohnRoebot</code> https://t.me/JohnRoebot текст <code>/get id</code>. Полученный числовой идентификатор вписать в поле Telegram chat_id.
Для каждого оператора системы можно указать его chat-id — это уникальный идентификатор пользователя в пределах сети Телеграм. Самый быстрый способ узнать свой chat-id - написать боту <code>@JohnRoebot</code> https://t.me/JohnRoebot текст <code>/get id</code>. Полученный числовой идентификатор вписать в поле Telegram chat_id.


[[Файл:Employee-telegram-chat_id.png]]
[[Файл:Employee-telegram-chat_id.png|center]]
 
Для выполнения теста отправки уведомлений, необходимо в поле "Получатель" указать его Chat ID. После нажать "Отправить".
 
[[Файл:2023-09-07_16-57.png|center]]


== Custom HTTP request ==
== Custom HTTP request ==
Строка 54: Строка 60:
''(Начиная с версии 3.15)''
''(Начиная с версии 3.15)''


[[Файл:Notifications_custom_url.png]]
[[Файл:Notifications_custom_url.png|thumb|800px|center]]


Следует указать URL и HTTP-метод, которым будет производиться вызов этого URL. Как видно из скриншота, URL содержит подстановочные поля:
Следует указать URL и HTTP-метод, которым будет производиться вызов этого URL. Как видно из скриншота, URL содержит подстановочные поля:
Строка 62: Строка 68:
Для каждого оператора системы можно указать его адрес получателя для Custom HTTP request.
Для каждого оператора системы можно указать его адрес получателя для Custom HTTP request.


[[Файл:Notifications staff custom http address.png]]
[[Файл:Notifications staff custom http address.png|thumb|800px|center]]
 
<br>
'''Начиная с версии 3.18:'''
 
<span id="anchor_318_155">Удалена работа с JABBER. Используйте службу уведомлений "Custom HTTP request" либо Messenger (Telegram).</span>
 
[[Файл:2023-05-01_18-36.png|thumb|800px|center]]
 
== Задания. Шаблоны сообщений ==
 
[[Файл:2024-03-01 19-45.png|thumb|800px|center]]
 
== Оборудование. Шаблоны сообщений ==
 
<span id="anchor_318_54">В настройку уведомлений добавлена возможность настройки шаблонов сообщений о пропадании/появлении активности у оборудования.</span>
 
[[Файл:2023-04-21_20-57.png|thumb|800px|center]]
 
[[Файл:2023-04-21_20-58.png|thumb|800px|center]]

Текущая версия от 17:46, 1 марта 2024

en | ru

В разделе "Настройка" => "Уведомления" собран функционал управления средствами доставки разнообразных уведомлений.

Настройте требуемые параметры.

Электронная почта

Вы можете выбрать один из двух видов транспорта:

SMTP

При выборе данного типа транспорта необходимо указать адрес SMTP сервера и порт. Если сервер использует шифрование, укажите его тип и задайте соответствующий порт. Если сервер требует аутентификации - укажите имя пользователя и пароль.

Если Вы используете общедоступный SMTP сервер общественных почтовых служб (Google, Yandex и т.д.), то все необходимые настройки найдете в разделе Помощь вашей службы.

sendmail

При выборе данного типа транспорта необходимо указать путь к sendmail и параметр для запуска отправки почты -bs или -t Строка настроек должна иметь вид /usr/sbin/sendmail -bs или /usr/sbin/sendmail -t

SMS

Telegram

(Начиная с версии 3.15)

В меню: "Настройка" => "Уведомления" => "Messenger" необходимо выполнить следующие настройки.

1. Служба - Telegram

2. Bot token - указать API-токен вашего бота, через которого будет осуществляться отправка. Чтобы создать Telegram-бота и/или получить его API-токен, необходимо написать боту @BotFather https://t.me/BotFather и выбрать в меню создание нового бота, если у вас его еще нет, после чего через меню запросите его API-токен. API-токен выглядит примерно следующим образом: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

3. URI прокси-сервера - необязательно - укажите URI прокси, если используете, вместе с протоколом и номером порта. Например, socks://telegram.proxy или tcp://telegram.proxy:8125 и т.п.

4. Parse Mode - необязательно - укажите режим обработки текста сообщения. Можно выбрать между режимами "простой текст" и режимами "Markdown", "HTML". Подробнее в документации: https://core.telegram.org/bots/api#formatting-options

Телеграм бот сможет отправлять сообщения пользователям телеграм только после того, как пользователь телеграм запустит бота. Для этого нужно открыть чат с ботом, затем нажать "Запустить" внизу чата, после чего написать что угодно боту, например, /start. Далее необходимо узнать chat-id пользователя Телеграм, которому бот должен будет отправлять сообщения, и внести его в данные пользователя Userside.

Для каждого оператора системы можно указать его chat-id — это уникальный идентификатор пользователя в пределах сети Телеграм. Самый быстрый способ узнать свой chat-id - написать боту @JohnRoebot https://t.me/JohnRoebot текст /get id. Полученный числовой идентификатор вписать в поле Telegram chat_id.

Для выполнения теста отправки уведомлений, необходимо в поле "Получатель" указать его Chat ID. После нажать "Отправить".

Custom HTTP request

Custom URL

(Начиная с версии 3.15)

Следует указать URL и HTTP-метод, которым будет производиться вызов этого URL. Как видно из скриншота, URL содержит подстановочные поля:

  • {recipient_address} — это значение будет заменено на адрес получателя
  • {message} — это значение будет заменено на текст сообщения

Для каждого оператора системы можно указать его адрес получателя для Custom HTTP request.


Начиная с версии 3.18:

Удалена работа с JABBER. Используйте службу уведомлений "Custom HTTP request" либо Messenger (Telegram).

Задания. Шаблоны сообщений

Оборудование. Шаблоны сообщений

В настройку уведомлений добавлена возможность настройки шаблонов сообщений о пропадании/появлении активности у оборудования.