Autotask tile
Table of Contents
Introduction
Autotask is an integrated IT business management solution, that enables you to track IT tickets and projects and which supports the IT services within your company. Organizations can use Autotask to provide internal IT support, and Managed Service Providers to provide support to their customers. With this live tile you can show the tickets of the currently signed in user.
In Autotask you create an API user with a password and tracking identifier (API key). This information is needed when setting up the Autotask connection in Workspace.
When clicking on a ticket from the live tile to view more detailed information, you will be redirected to your Autotask environment (/ClientPortal/ServiceTickets/ServiceTicketDetail.aspx). The same goes for creating a ticket from the live tile (/ClientPortal/ServiceTickets/NewTicket.aspx). Currently there is no UI for viewing detailed ticket information in Workspace.
Requirements
The username which you need to fill in in the Autotask dialogue in Workspace when creating the Autotask connection (step 2), does not have to exist in the Workspace. These credentials are required for the API call to Autotask. However, in order to view the tickets in the Autotask live tile as a user, the Workspace user must match with the email address of the Autotask user.
Configuration
Step 1. Creating a new API user in Autotask
- Login to the Autotask admin portal.
- Navigate to Account settings and Users.
- Select Resources/Users (HR).
- Then click Resources/Users.
- Click the arrow next to the +New button at the top left corner.
- Choose New API user.
General section:
- Define a name and link a valid email address.
- Choose the correct security level.
“API User (system) Can’t Read Costs” is recommended. - Set the correct Primary Internal Location.
Credentials section:
- Click Generate Key in the Credentials section to generate a username.
- Click Generate Secret in the Credentials section to generate a password (secret).
API Tracking Identifier section:
- By default, the selection is correct and should be on Integration vendor.
- In the drop-down labelled 'Integration Vendor' pick Workspace 365 – Cloud Service Delivery.
(This links the API user to our integration with Autotask)
Line of business:
- Provide the correct line of business to grant the integration access to the tickets in the required domain.
- Click Save & Close at the top of the screen to save the new API user.
Step 2. Create an Autotask connection
- As an administrator, go to the admin Settings.
- Navigate to Integrations and select Autotask Connections.
- Click New.
- Fill in the following information:
- Name: this is the name of the Autotask connection in Workspace.
- Username: this is the Username from your Autotask. This can be a newly created account in Autotask.
- Password: you need to have a password for this account.
- Click Add.
Step 3. Configure the app
- After creating the Autotask connection, you can configure the app. Go to the App store.
- Make sure that Manage apps is selected.
- Click Add new app.
- Search for the Autotask app and click Add.
- Here you choose the app icon, color and name. You can select the connection created in step 1 (or if needed, create a new one by clicking on "Add"). The destination will determine if the app opens in the current window or a new one.
- You can also determine who has access or who will become app owner.
- Click Save when you're done.
Step 4. Activate the app
- Once the the Autotask tile has been configured correctly, add the tile to your Workspace by clicking on +Add tiles.
- Search for Autotask from the App store and add it to your Workspace (either to an existing or new group).
- When added to Workspace, you can edit the tile to your liking by right-clicking it.
