How do I set up an Autotask integration with my Datto device?
- Datto NAS
This article explains how to configure and use the Autotask integration with your Datto devices. The Autotask integration allows a Datto appliance to create tickets in your environment from alerts.
Before starting, ensure that your Autotask setup has the following criteria in place:
- A user account with administrator credentials for the Datto appliance to use to access your Autotask environment.
- A configuration type in your Autotask environment for Datto to use for devices.
When your Datto appliance generates an alert, Datto's Autotask integration can open a ticket on your service board.
For a device or an agent alert to create a ticket, you must first set an email address for that type of alert. An email address is what tells the device to raise alert messages. See Configuring Alerts In The Partner Portal and Configuring Alerts In The Remote Web for information about setting up these alerts. Later in the setup, you can decide if you want to actually receive emails, but having one in place is necessary for the alerting process to begin.
Companies and Accounts
For the Datto API to create tickets, make sure you have an account in Autotask for each end-user company to which you plan to link Datto devices.
Create a Configuration Type
You will also need a special configuration item to add the devices to. Datto recommends that you create a new configuration item for this purpose.
To create a new configuration type, hover your mouse over the Autotask icon in the upper right-hand corner. In the flyout, hover over Admin, and then click on Features & Settings.
Figure 1: Select Features & Settings
On the Features and Settings page, expand the Configuration Items box, and then click on Configuration Item Types.
Figure 2: Select Configuration item types
After the data populates, click on New Configuration Item Type. Give the item a name. Check the Active box. Then, click Save and Close.
Figure 3: Create the configuration item
Service Desk Queue
Each device needs to have an Active Queue, Issue Type, and Sub-Issue Type for tickets to generate in Autotask. You can use a preexisting service queue if it has these criteria marked as active. You can configure this in the Features and Settings page.
Configure the Partner Portal
Log into the Partner Portal with an administrator account.
Figure 4: Log into the partner portal
Hover over the Admin menu, and click on Integrations. When the page loads, click on the Autotask tab.
Figure 5: Click Autotask
If this is your first time setting up an Autotask integration, you will see a username and password field. Enter Autotask user administrator credentials.
Complete the Billing Code Type, Billing Code Name and Configuration Type drop-downs in both columns. For the Configuration Type drop-down, use the configuration item type you created earlier. Click Submit.
A list of the devices in your fleet will populate. Select the device you want to configure. In the Company field, enter the name of the company with which you want to associate the device. When associating devices, use the company names you created in Autotask.
As you enter the name, a drop-down like the one shown in the above example will appear. Click on the company in the drop-down to select it. If the drop-down does not populate, clear the field, and type the company name again. When completed, click Save.
Figure 6: Select the device to configure
The UI will save any changes you make on this screen.
Figure 7: The device assigned to a company.
The Alerts categories allow you to define where the integration should send each type of alert. There are three options for each alert type:
- Email: This setting will send the alert via email, but it will not create a ticket in Autotask.
- Autotask: This setting creates a ticket in Autotask, but it will not send an email.
- Both: This setting creates a ticket in Autotask, and sends an email to the address you specify.
You must have an email address added to the Device Email alerts section of the partner portal in order to receive alerts. To add your email:
- select Devices in the partner portal drop-down menu, then choose Status 2.0
- Choose the device from which you wish to receive alerts
- Click Device Alerts on that device's information page.
See this article for more information on configuring device alerts.
The Ticket Configuration fields should match the values defined by your Autotask Administrator. As a best practice, select General allocation code. This represents work types in your Autotask database. For Device/Product, as a best practice, select Material Cost Code and Hardware. After you set these values, you can click Send Test Ticket to verify that the settings work.