Предупреждения данных предоставляет открытые API для получения оповещений через кастомные платформы и приложения, что существенно увеличивает эффективность работы с оповещениями.
Метод настройки#
Перед началом необходимо установить предупреждения данных и настроить соответствующие права.
Где настраивать#
Войдите на платформу под администратором, выберите Система > Предупреждение данных, нажмите на иконку настроек для перехода к странице настройки оповещений от сторонних приложений, далее нажмите Добавить приложение — начнётся настройка.
Страница настройки#
Заполните следующие поля в соответствии с вашими задачами (описание параметров ниже).
| Параметр | Обязательный | Описание |
|---|---|---|
| Имя приложения | Да | Задаётся пользователем. |
| Пояснение к приложение | Нет | Краткое описание приложения. |
| Статус приложения | Да | Обязательный. Может быть Включено (по умолчанию) или Отключено. Включено: При создании задачи-оповещения, выбрав Уведомление через клиент, можно выбрать это приложение как терминал для push-уведомлений. Отключено: Приложение не будет доступно для выбора в push-терминалах. |
| URL-адрес запроса | Да | URL для запросов на доставку оповещения. |
| Способ запроса | Да | POST (по умолчанию) или GET. |
| Заголовок запроса | Да | Пары ключ-значение для заголовков (можно добавить несколько). |
| Тело запроса | Нет | Тело запроса (json, xml или txt), которое будет отправляться приложению при срабатывании алерта. Поддерживаются параметры: Время срабатывания: ${triggeredTime} (формат yyyy-MM-dd HH:mm:ss) Название оповещения: ${taskName} Шаблон: ${templatePath} Ссылка для доступа: ${targetLink} (относительный адрес на платформе) Условие срабатывания: ${ruleDescription} Получатели: ${receiveUsers} (строка, значения перечислены через запятую) Количество срабатываний: ${ruleMatchDataCount} Максимальное значение: ${ruleMatchDataMax} Минимальное значение: ${ruleMatchDataMin} Примечание: Если в теле запроса добавлен параметр ${notifyContent}, фактическое уведомление в приложении складывается из введённого в теле текста плюс контент оповещения, заданный на странице создания алерта. Если параметра нет — используется только текст из тела запроса. |
Настройка алерта#
После сохранения этой настройки пользователь с правом предупреждения данных может выбрать Уведомление интерфейса приложения в пункте Способ уведомления и указать нужное приложение.
После создания алерта в приложении будет отображаться составное уведомление: контент из поля тело запроса плюс указанный пользователем текст уведомления на этапе создания оповещения.
Супер-администратор задаёт общую структуру текста уведомления (в теле запроса), а пользователь может дополнительно ввести свой текст прямо в настройках оповещения — таким образом содержание становится гибким.