TeamViewer Custom Widget

Overview

TeamViewer custom widget enables you to access their TeamViewer account from within ServiceDesk Plus.

This article provides easy-to-follow, step-by-step instructions to add a fully operational TeamViewer custom widget in your ServiceDesk Plus instance.

Step 1: Create TeamViewer OAuth app

Log in to TeamViewer.
Go to Profile Settings > Apps and create a new OAuth app.
Select the checkboxes for the following scopes on the right side:
- Session management:
  - Create, view, and edit sessions for the company.
- Meetings:
  - View, create, edit, and delete meetings.

Set the Redirect URI as: $buildUrl/integration/oauth/callback (replace $buildUrl with the actual ServiceDesk Plus hosted domain)
Click Create.
Copy the generated Client ID and Client Secret.

Step 2: Create TeamViewer Connection in ServiceDesk Plus

In ServiceDesk Plus,

Go to Admin > Developer Space > Connections > Custom Services.
Click Create Service.
Name the service and service link as teamviewer.

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

Choose OAuth2 as the Authentication Type.
Paste the Client ID and Client Secret from the TeamViewer OAuth app.
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
Click Create Service.
After you create the service, click Create Connection.
Name the connection and connection link as teamviewer (similar to service name).
Click Create And Connect.

Step 3: Establish the connection

After creating the connection, click Connect. You will be prompted to enter the username and password. Use TeamViewer credentials and click Connect.
Copy the JSON code snippet of the connection.

Step 4: Configure the widget file

Download the custom widgets zip from here.
Open the plugin-manifest.json file.
Locate the connection array in the plugin manifest file and update it with the copied JSON, as follows:

"connections": [

{

"connectionLinkName": "teamviewer",

"connectionName": "teamviewer",

"serviceName": "teamviewer",

"userAccess": false,

"isUserDefinedService": true,

"sharedBy": "5"

}

]

4. After you complete the configuration, re-zip all the files of the widget.

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

Step 5: Upload the TeamViewer Custom Widget

In ServiceDesk Plus,

Go to Admin > Developer Space > Custom Widget > + Custom Widget.
Enter a name for the custom widget.
Upload the zipped widget file. The supported file format is .zip and the maximum file size is 5MB.
Click Save.

Now, you should be able to access the fully operational TeamViewer custom widget.

How to access the TeamViewer custom widget in ServiceDesk Plus

Go to an existing request in ServiceDesk Plus.
You should now see a TeamViewer pane added to the request details page on the right side.

In the widget, click Create a Remote session to access the requester's computer screen.
Click Create a Pilot session to enable requesters to live stream.
Click Session History to view the previous session history.