⌘ K

ServiceDesk Plus · Для администраторов

Пользовательский виджет Zoom

Обзор

Пользовательский виджет Zoom позволяет создавать и планировать встречи Zoom непосредственно в ServiceDesk Plus.

В статье приведены понятные пошаговые инструкции настройки пользовательского виджета Zoom в ServiceDesk Plus.

 Шаг 1: создание приложения Zoom 

  1. ОткройтеZoom Marketplace.

  2. Войдите в Zoom или зарегистрируйте учётную запись.

  3. Перейдите в разделРазработка (Develop) >Создать приложение (Build App). 

  4. ВыберитеОбщее приложение (General App). 

  5. НажмитеСоздать (Create)и следуйте инструкциям создания приложения.

Иллюстрация 1: Пользовательский виджет Zoom

  1. Выберите вариантПод управлением администратора (Admin-managed)в параметреВыбор способа управления приложением (Select how the app is managed).

  2. Введите следующий URL обратного вызова в OAuth Allow Lists:$buildUrl/integration/oauth/callback(замените $buildUrl URL вашей установки ServiceDesk Plus, например https://demo.servicedeskplus.com/integration/oauth/callback).

  3. СкопируйтеИдентификатор клиента (Client ID)исекрет клиента (Client Secret)и сохраните их для дальнейшего использования.

Иллюстрация 2: Пользовательский виджет Zoom

 

 Шаг 2: добавление областей доступа в приложение Zoom

  1. ОткройтеОбласти доступа (Scopes)в левой панели.

  2. Добавьте в приложение следующие области доступа:

    • meeting:read:list_meeting 

    • meeting:write:meeting

 Шаг 3: создание сервиса в ServiceDesk Plus

В ServiceDesk Plus:

  1. Перейдите в разделАдминистрирование (Admin) > Подключения (Connections) > Пользовательские сервисы (Custom Services).

  2. НажмитеСоздать сервис (Create Service).

  3. Назовите сервис и ссылку сервисаzoom. 

Service Name должно содержать только буквенно-цифровые символы одним словом или в формате snake_case, например zoom или sdp_zoom.
  1. ВыберитеOAuth2 кактип аутентификации (Authentication Type).

  2. ВставьтеИдентификатор клиента (Client ID)исекрет клиента (Client Secret), скопированные из приложения Zoom в разделе Раздел разработки (Development Section) > Основные сведения (Basic Information)).

  3. Введите следующие URL в соответствующие поля:

    • URL авторизации (Authorize URL): https://zoom.us/oauth/authorize

    • URL токена доступа (Access Token URL): https://zoom.us/oauth/token

    • URL токена обновления (Refresh Token URL): https://zoom.us/oauth/token

  4. Добавьте следующие области доступа с одинаковыми значениями в поляхОбласть доступа (Scope)иОтображаемое имя области (Scope Display Name). Нажмите значокплюсарядом с полемОтображаемое имя (Display Name)для добавления других областей доступа.

    • meeting:read:list_meeting

    • meeting:write:meeting

  5. НажмитеСоздать сервис (Create Service). 

Иллюстрация 3: Пользовательский виджет Zoom

 

Шаг 4: создание подключения Zoom в ServiceDesk Plus

  1. После создания сервиса нажмитеСоздать подключение (Create Connection).

  2. Укажите имя подключения и имя ссылки какzoom(как и имя сервиса).

  3. НажмитеСоздать и подключить (Create And Connect).

Иллюстрация 4: Пользовательский виджет Zoom

Шаг 5: установка подключения 

  1. НажмитеПодключить (Connect). Появится запрос имени пользователя и пароля. Используйте учётные данные Zoom для установки подключения Zoom.

Иллюстрация 5: Пользовательский виджет Zoom

  1. Скопируйте фрагмент JSON для обновления файла виджета.

 

Шаг 6: настройка файла виджета

  1. Скачайте ZIP-файл пользовательского виджета для версии сборки ServiceDesk Plus.
    Для сборок ниже 15200: нажмитездесь.
    Для сборок 15200 и выше: нажмите здесь.

  2. Откройте файл манифеста плагина (plugin-manifest.json) в архиве ZIP.

  3. Найдите массив connections и обновите его скопированным JSON, как показано ниже:

"connections": [
{
   "connectionLinkName": "zoom",
   "connectionName": "zoom",
   "serviceName": "zoom",
   "userAccess": false,
   "isUserDefinedService": true,
   "sharedBy": "5"
}
]

 

  1. После настройки заново упакуйте все файлы виджета в ZIP.

Не упаковывайте папку целиком. Выберите все файлы по отдельности и упакуйте их.

 Шаг 7: загрузка виджета Zoom

В ServiceDesk Plus:

  1. Перейдите в разделАдминистрирование (Admin) > Раздел разработчика (Developer Space) > Пользовательский виджет (Custom Widget) > + Пользовательский виджет (+ Custom Widget).

  2. Введите имя пользовательского виджета.

  3. Загрузите архив виджета. Поддерживается .zip, максимальный размер — 5 МБ.

  4. НажмитеСохранить (Save).

Теперь в ServiceDesk Plus должен быть доступен полностью работающий пользовательский виджет Zoom.

Как открыть пользовательский виджет Zoom в ServiceDesk Plus

  1. Откройте существующую заявку в ServiceDesk Plus.

  2. Справа на странице сведений о заявке должна появиться панель Zoom.

  3. В виджете нажмитеНачать встречу (Start Meeting)для создания и планирования встречи Zoom из ServiceDesk Plus.

  4. НажмитеИстория сеансов (Session History)для просмотра истории предыдущих встреч.

Иллюстрация 6: Пользовательский виджет Zoom