Zoom Custom Widget

Overview 

The Zoom custom widget enables you to create and schedule meetings in Zoom from within ServiceDesk Plus. 

This article provides easy-to-follow, step-by-step instructions to set up the Zoom custom widget in ServiceDesk Plus. 

 Step 1: Create Zoom App 

  1. Go to the Zoom Marketplace.

  2. Log in or sign up for a Zoom account.

  3. Go to Develop > Build App. 

  4. Select General App. 

  5. Click Create and follow the instructions to create the app.

  1. Select the Admin-managed option for Select how the app is managed.

  2. Enter the following callback URL in the OAuth Allow Lists: $buildUrl/integration/oauth/callback (replace $buildUrl with your ServiceDesk Plus build URL. For ex: https://demo.servicedeskplus.com/integration/oauth/callback)

  3. Copy the Client ID and Client Secret and make a note of them for later use. 

 

 Step 2: Add Scopes to Zoom App

  1. Go to Scopes in the left pane. 

  2. Add the following scopes to your app:

 Step 3: Create a Service in ServiceDesk Plus 

In ServiceDesk Plus,

  1. Go to Admin > Connections > Custom Services.

  2. Click Create Service.

  3. Name the service and service link as zoom. 

The Service Name must contain only alphanumeric characters, either as a single word or in snake case. For example, zoom or sdp_zoom.

  1. Choose OAuth2 as the Authentication Type.

  2. Paste the Client ID and Client Secret copied from the Zoom app (found under Development Section > Basic Information).

  3. Enter the following URLs in the respective fields:

  4. Add the following scopes with the same values for both Scope and Scope Display Name fields. Click the plus icon next to the Display Name field to add more scopes.

  5. Click Create Service. 

 

 Step 4: Create a Zoom Connection in ServiceDesk Plus 

  1. After you create the service, click Create Connection.

  2. Enter the connection name and link name as zoom (similar to the service name).

  3. Click Create And Connect.

 Step 5: Establish the Connection 

  1. Click Connect. You will be prompted to enter the username and password. Use Zoom credentials to establish the Zoom connection. 

  1. Copy the JSON code snippet to update the widget file. 

 

 Step 6: Configure the Widget File

  1. Download the custom widgets zip from here.

  2. Open the plugin manifest file (plugin-manifest.json) in the zip.

  3. Locate the connection array in the file and update it with the copied JSON, as follows:

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

 

  1. After completing the configuration, re-zip all the files of the widget.

Do not zip the folder. Instead, select all the files individually and zip them. 

 Step 7: Upload the Zoom Widget 

In ServiceDesk Plus,

  1. Go to Admin > Developer Space > Custom Widget > + Custom Widget.

  2. Enter a name for the custom widget. 

  3. Upload the zipped widget file. The supported file format is .zip and the maximum file size is 5MB.

  4. Click Save.

You should now be able to access the fully functional Zoom custom widget in ServiceDesk Plus.

 How to Access the Zoom Custom Widget in ServiceDesk Plus 

  1. Go to an existing request in ServiceDesk Plus.

  2. You should now see a Zoom pane added to the request details page on the right side.

  3. In the widget, click Start Meeting to create and schedule a meeting in Zoom from ServiceDesk Plus.

  4. Click Session History to view the previous meetings' history.