Configure TOPdesk
Table of Contents
- Overview
- Requirements
- Configure TOPdesk for a single Workspace tenant
- Configure one TOPdesk for all Workspaces on an instance
Overview
There are two scenarios for configuring TOPdesk in Workspace.
TOPdesk within a Workspace Tenant (update 3.11)
In Update 3.11 we are introducing a upgraded version of the TOPdesk live tile. In this version you are able to enable any organization to take advantage of the benefits of TOPdesk! This way, both IT Support and other employees can instantly view and open support tickets from the TOPdesk live tile. Based on people’s login to the Workspace, the tile will instantly show the correct support tickets.
TOPdesk configuration on instance level (update 2.64)
In update 2.64 we introduced TOPdesk live tile for Workspace. This configuration will give you the change to configure one TOPdesk for all the Workspaces on the instance. As an admin you need to do additional configuration to connect to your TOPdesk account.
- Configure TOPdesk for a single Workspace tenant
- Configure one TOPdesk for all Workspaces on an instance
Requirements
TOPdesk URL
This is the URL where your TOPdesk is available on.
Username
This is the Username from your TOPdesk. This can be a newly created account in TOPdesk. This account must have the 'Operator' role. Make sure this user has at least 'read permission'.
App password
As last you need to generate an app password. Follow the documentation described here https://developers.topdesk.com/tutorial.html#show-collapse-usage-createAppPassword
Configure TOPdesk for a single Workspace tenant
- Go to the Settings
- Go to Integrationss
- Click on TOPdesk Connections
- Click New
In this config there are three variables you need to set:
- Name
- TOPdesk URL
- Username
- Application password
Configure one TOPdesk for all Workspaces on an instance
This configuration is only possible on instance level. With this Configurations you can only configure one TOPdesk for all Workspaces.
Custom info can be changed via the Connectionstring settings, found in \inetpub\wwwroot\{tenant name}\{workspace folder}\Configs\ConnectionStrings.config
<add name="TopDesk" connectionString="Address={{TOPdesk url}};Username={{Username}};ApplicationPassword={{Application password}}"/>
In this config there are three variables you need to set:
- {{TOPdesk url}}
- {{Username}}
- {{Application password}}
You need to set these to your own TOPdesk configuration.
Example:
<add name="TopDesk" connectionString="Address=https://topdesk.info.com;Username=TopDeskUser;ApplicationPassword=37d-djf2-dsa3"/>