(Download the custom widgets zip from here.)
Zoom Custom Widget
Step 1: Creating a Zoom App:
a. Navigate to the Zoom Marketplace.
b. Login or sign up for a Zoom account.
c. Go to Develop > Build App - >
d. Select General App and follow the instructions to create the app.
e. Enter the OAuth callback URL as:
$buildUrl/integration/oauth/callback
(For ex: https://demo.servicedeskplus.com/integration/oauth/callback)
f. Enable the Admin Managed option.
Step 2: Adding Scopes:
a. Go to Scopes in the left pane and and the following scopes to your app:
meeting:write:meeting:admin
meeting:write:meeting:master
Step 3: Creating a Zoom Connection in ServiceDesk Plus:
a. Go to Admin > Connections.
b. Create a new Service with the name as zoom and choose OAuth as the Authentication Type.
c. Paste the Client ID and Client Secret from the Zoom app (found under Development Section > Basic Information).
Enter the following URLs:
Authorize URL: https://zoom.us/oauth/authorize
Access Token URL: https://zoom.us/oauth/token
Refresh Token URL: https://zoom.us/oauth/token
d. Complete the connection setup.
Step 4: Configure Connections in the Plugin Manifest File:
a. After creating the Zoom connection, navigate to Admin > Developer Space > Connections.
b Copy the JSON code snippet for the connection.
c. Update your plugin manifest file (plugin-manifest.json) in the zip with the copied JSON:
For example,
"connections": [
{
"connectionLinkName": "zoom",
"connectionName": "zoom",
"serviceName": "zoom",
"userAccess": false,
"isUserDefinedService": true,
"sharedBy": "5"
}
]
Step 5: Uploading the Zoom Custom Widget:
a. Zip your app folder and include the plugin-manifest.json file.
(Select all the files individually and zip it)
b. Upload the zipped file by navigating to Admin > Developer Space > Custom Widgets.
c. The Zoom widget has been upload successfully and is fully operational now.
Zoho Meeting Custom Widget
Step 1: Creating a Zoho Meet Connection:
a. Navigate to the Zoho API Console and click GET STARTED.
b. Choose Server-Based Application and enter the Authorized Redirect URI as:
$buildUrl/integration/oauth/callback
(For ex: https://demo.servicedeskplus.com/integration/oauth/callback)
c. Specify the Homepage URL with your ServiceDesk Plus hosted domain alone.
d. Once specified click on Create and make a note of the Client ID and Secret generated.
Step 2: Creating Connection in SDP:
a. Go to Admin > Developer Space > Connections.
b. Create a new service with the name as zohomeet and choose OAuth as the Authentication Type.
c. Paste the Client ID and Client Secret from the Zoho API Console.
Enter the following URLs:
Authorize URL:
https://accounts.zoho.com/oauth/v2/auth?access_type=offline&prompt=consent
Access Token URL: https://accounts.zoho.com/oauth/v2/token
Refresh Token URL: https://accounts.zoho.com/oauth/v2/token
Add the following scopes:
ZohoMeeting.meeting.READ
ZohoMeeting.webinar.CREATE
ZohoMeeting.meeting.DELETE
ZohoMeeting.meeting.CREATE
ZohoMeeting.webinar.UPDATE
ZohoMeeting.manageOrg.READ
ZohoMeeting.webinar.READ
ZohoMeeting.meeting.UPDATE
ZohoMeeting.webinar.DELETE
d. Click on Create Service and create a connection with all the scopes chosen and connect the zohomeet connection with admin account.
Step 3: Configure Connections in the Plugin Manifest File:
a. After creating the Zoho Meet connection, navigate to Admin > Developer Space > Connections.
b. Copy the JSON code snippet for the connection.
c. Update your plugin-manifest.json file with the copied JSON:
For example,
"connections": [
{
"connectionLinkName": "zoho_meet",
"connectionName": "zoho_meet",
"serviceName": "zoho_meet",
"userAccess": false,
"isUserDefinedService": true,
"sharedBy": "5"
}
]
Step 4: Uploading the Zoho Meet Custom Widget:
a. Zip the files including the plugin-manifest.json file.
b. Upload the zipped file by navigating to Admin > Developer Space > Custom Widgets.
c. The Zoho Meeting widget has been upload successfully and is fully operational now.
TeamViewer Custom Widget
Step 1: Creating a TeamViewer OAuth App:
a. Log in to TeamViewer.
b. Go to Profile Settings > Apps and create a new OAuth app.
c. Add the following scopes:
Session management:
Create, view, edit sessions for the company.
Meetings:
View, create, edit, delete meetings.
d. Set the Redirect URL as:
$buildUrl/integration/oauth/callback
Step 2: Creating a TeamViewer Connection in SDP:
a. Navigate to Admin > Developer Space > Connections.
b. Create a new service and choose OAuth as the Authentication Type.
c. Paste the Client ID and Client Secret from the TeamViewer OAuth app.
d. Enter the following URLs:
Authorize URL: https://login.teamviewer.com/oauth2/authorize?display=popup
Access Token URL: https://webapi.teamviewer.com/api/v1/oauth2/token
Refresh Token URL: https://webapi.teamviewer.com/api/v1/oauth2/token
Step 3: Configure Connections in Plugin Manifest File:
a. After creating the TeamViewer connection, navigate to Admin > Developer Space > Connections.
b. Copy the JSON code snippet for the connection.
c. Update your plugin-manifest.json file in the zip file with the copied JSON:
For example,
"connections": [
{
"connectionLinkName": "teamviewer",
"connectionName": "teamviewer",
"serviceName": "teamviewer",
"userAccess": false,
"isUserDefinedService": true,
"sharedBy": "5"
}
]
Step 4: Uploading the TeamViewer Custom Widget:
a. Zip the files including the plugin-manifest.json file.
b. Upload the zipped file by navigating to Admin > Developer Space > Custom Widgets.
c. The TeamViewer widget has been upload successfully and is fully operational now.