Интеграция с Microsoft Teams

Первым действием является создание приложения в ПО Microsoft Teams.

Для создания приложения команд:

1. Выполните вход в ПО Microsoft Teams в качестве администратора.
2. На вкладке Apps (Приложения) выполните поиск и добавьте App Studio.
3. На вкладке Manifest editor (Редактор манифестов) в App Studio выберите Create new app (Создать новое приложение).
4. Обязательно укажите следующие значения:
• Краткое имя
• Полное имя
• Краткое описание
• Полное описание
• Имя пакета (например, название_вашей_компании.isdteamsapp.com)
• Версия (например, 1.0.0)
• Краткое описание
• Длинное описание
• Информация разработчика (например, ваше имя и веб-адрес вашей организации)
• URL-адрес веб-сайт (необходим префикс https://)
• URL-адрес уведомления о конфиденциальности (необходим префикс https://)
• URL-адрес условий использования (необходим префикс https://)
5. Нажмите Generate (Создать).
   Будет создан ИД приложения.
6. В диалоге Capabilities (Возможности) выберите Bots (Боты), а затем нажмите Set up (Настройка).
7. Введите значение Name (Имя), выберите My bot is a one-way notification bot (Мой бот - односторонний бот оповещений) и установите значение Scope (Область действия) для Team (Команда).
8. Нажмите Create bot (Создать бот).
   Бот будет создан и отображен на странице ботов с идентификатором, который используется в системных настройках Service Desk в качестве ИД бота.
   
9. Нажмите Generate new password (Создать новый пароль).
   Пароль будет создан и должен использоваться в системных настройках Service Desk в качестве значения Пароль бота.
10. В форме введите адрес конечной системы бота:
    https://[URL-адрес сервера]/[имя экземпляра инфраструктуры]/api/messages?v=*
    Например:
    https://my.example.org/servicedesk.framework.web/api/messages?v=*
11. На вкладке проверки и распространения загрузите приложение команд в виде файла zip.
    

После создания приложения его необходимо загрузить.

Для загрузки приложения Teams в вашей организации:

1. Выполните вход в ПО Teams в качестве администратора.
2. На вкладке Apps (Приложения) нажмите Upload a custom app (Загрузить особое приложение) и загрузите файл zip, полученный в предыдущем разделе.
   Отобразится название загруженного приложения.
3. Выберите название приложения и нажмите Add to a team (Добавить для команды).
4. Найдите нужную команду и нажмите Set up a bot (Установить бот).
   Приложение Teams будет установлено для выбранной команды.

Теперь вы готовы к конфигурации Service Desk для использования приложения Teams, после чего вы сможете добавлять пользователей в приложении Teams.

После создания приложения Teams и его загрузки вы можете сконфигурировать интеграцию между ним и Service Desk. Для этого необходимо добавление некоторых системных настроек Service Desk из конфигурации приложения Teams и последующее добавление участника в соответствующую команду, а затем возврат к системным настройкам Service Desk для включения и дальнейшей конфигурации интеграции.

Для конфигурации интеграции Service Desk и приложения Teams:

1. Выполните вход на консоль Service Desk в качестве администратора.
2. В меню Настройки нажмите Система.
   Появится страница системных настроек.
3. В разделе Интеграция команд установите следующие значения:
   ИД бота – идентификатор, созданный в ПО Microsoft Teams во время создания бота.
   Пароль бота – пароль, созданный в ПО Microsoft Teams после создания бота.
   Связать с командой – URL-адрес, созданный после выбора Получить ссылку команды в контекстном меню команды.
   URL-адрес изображения оповещения – URL-адрес изображения, которое должно отображаться с оповещениями команд.
4. Сохраните настройки.
   На следующем этапе нужно сделать значение Url-адрес службы только для чтения, что можно выполнить, когда первое сообщение отправляется в Service Desk Framework во время следующих действий.
5. В Центре конфигурации Service Desk уничтожьте пул приложений инфраструктуры.
6. В ПО Microsoft Teams добавьте пользователя в команду, для которой установлено приложение оповещений Service Desk.
   Это отправит сообщение в Service Desk Framework и заполнит системную настройку, Url-адрес службы.
7. На странице системных настроек Service Desk в диалоге Интеграция команд установите для Включить оповещения команд значение True и проверьте, что настройка Url-адрес службы имеет значение.