Интеграция с Telegram позволяет оперативно получать уведомления по новым событиям системы ГИС Airlay (далее – Система).

Для корректной работы получения уведомлений необходимо произвести следующие настройки:

1. Создать новую категорию;
2. Создать email шаблон;
3. Создать email уведомление;
4. Создать новую группу в Telegram;
5. Создать задачу.

В Системе, категория позволяет устанавливать новые статусы/атрибуты для событий. Например: произошло событие №1, для него автоматически присваивается статус (категория) с атрибутом «Новая». В дальнейшем, диспетчер для обработки события переводит в статус (категория) с атрибутом «Закрыта». Для создания новой категории необходимо:

1. Войти в консоль администрирования;
2. Перейти в раздел «Категории» ;
3. Нажать кнопку «Добавить» .

В открывшемся окне «Создание новой схемы»:

1. В поле «Имя *» ввести отображаемое наименование в разделе;
2. В поле «Набор данных» выбрать набор данных, в котором хранятся объекты;
3. В поле «Геометрия» выбрать необходимую геометрию объектов, по которым будут создаваться события (по умолчанию можно выбрать все);
4. Выбрать необходимый цвет для данной категории (опционально)
5. Выбрать необходимую иконку для данной категории (опционально), путем нажатия на кнопку «Загрузить» ;
6. В поле «Название параметра *» ввести наименование атрибута (ключа), которое будет присваиваться объекту (латиница);
7. В поле «Значение по умолчанию *» ввести наименование значения, которое будет присваиваться объекту (кириллица);

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

Рисунок 1. Создание новой категории

Email шаблоны позволяют установить шаблоны параметров для отправляемых событий на Email или в Telegram. В основе формата данных параметров лежит шаблонизатор Mustache. В описание можно добавлять:

• HTML разметку;
• Значение атрибутов объекта;
• Вызов встроенных функций (например переход к событию на карту Системы);
• Конвертацию unixtime времени.

Справочную информацию по синтаксису Mustache можно найти по ссылке. Для создания нового email шаблона, необходимо:

1. Войти в консоль администрирования;
2. Перейти в раздел «Email шаблоны» ;
3. Нажать на кнопку «Добавить шаблон»;
4. Во вкладке «Тип» выбрать «Email о изменении задачи типа мониторинг»;
5. В поле «Название» ввести отображаемое наименование для данного раздела;
6. Нажать кнопку «Добавить».

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

Рисунок 2. Создание email шаблонов

Email уведомления, позволяют установить параметры по отправке уведомлений для событий. Не путать с email шаблонами! Параметрами будут являться: для какой категории с каким промежутком времени отправлять уведомления. Для создания нового email уведомления, необходимо:

1. Войти в консоль администрирования;
2. Перейти в раздел «Email уведомления» ;
3. В поле «Название уведомления» ввести отображаемое имя уведомления;
4. Нажать на кнопку «Добавить» .

После создания нового уведомление, откроется окно справа, где необходимо: Выбрать шаблон сообщения (которое создавалось в разделе «Email шаблоны»); В поле «Категория» выбрать необходимую категорию, которую создавали в разделе «Категории»; В поле «Повторная отправка (сек)» ввести необходимый параметр для повторной отправки в секундах.

P.S. При установке значения «-1» - уведомление будет отправляться 1 раз и отображаться в списке событий в задаче. При установке значения «0» - уведомление будет отправляться 1 раз и НЕ будет отображаться в списке событий в задаче (применимо для событий со статусом «Закрыто»).

Рисунок 3. Создание email уведомления

Для создания новой группы в Telegram, необходимо:

1. Авторизоваться в своей учетной записи;
2. Нажать кнопку «Дополнительно» ;
3. Нажать кнопку «Создать группу» ;
4. В поле «Название группы» ввести наименование создаваемой группы;
5. При необходимости добавить фотографию (опционально);
6. Нажать кнопку «Далее»;
7. В открывшемся окне «Добавить участников» ввести «AirlayBot», нажать ЛКМ по боту и нажать кнопку «Создать»;
8. Сохранить полученный идентификатор от AirlayBot.

Рисунок 4. Создание новой группы в Telegram

P.S. Для получения уведомлений в Telegram, необходимо создавать именно «Группу». «Каналы» в Системе, для получения уведомлений – не работают.

Для создания новой задачи, необходимо (обязательные отмечены полужирным):

1. Перейти в раздел «Задачи» из консоли администрирования или параметров ;
2. Нажать на кнопку «Создать задачу»;
3. Выбрать статус задачи (опционально);
4. В поле «Название задачи» ввести необходимое наименование задачи;
5. В поле «Добавьте описание» ввести необходимое описание задачи (опционально);
6. В поле «Ответственный» выбрать необходимого ответственного за задачу (опционально);
7. Выбрать приоритет задачи (опционально);
8. В поле «Мероприятие» выбрать родительское мероприятие для задачи (опционально);
9. В поле «Уведомления» выбрать необходимое уведомление, которое создавали раннее;
10. В поле «Тип» выбрать «Мониторинг»;
11. В поле «Дата начала» и «Дата окончания» выбрать необходимую дату (опционально);
12. В поле «Оценка времени» и «Затраченное время» выбрать необходимое время (опционально);
13. В поле «Выполнение» выставить необходимый процент выполнения (опционально);
14. В поле «Родительские задачи» добавить необходимые родительские задачи (опционально);
15. В поле «Дочерние задачи» добавить необходимые дочерний задачи (опционально)
16. Нажать на кнопку «Создать».

Рисунок 5. Создание новой задачи

Рисунок 6. Новая задача

Для настройки интеграции необходимо: Во вкладке «Список объектов» добавить необходимый набор данных, где хранятся объекты; Во вкладке «Инциденты» добавить необходимый набор данных, где будут храниться события; Во вкладке «Наблюдатели» нажать на кнопку «Добавить» ; В открывшемся окне выбрать «Telegram» и вставить полученный идентификатор от AirlayBot; Нажать на кнопку «Добавить».

Рисунок 7. Добавление идентификатора Telegram