This document shows an example of what needs to be done in Autotask to make it integration-ready with ONEiO. The document also describes what ONEiO needs to be able to send messages to the Autotask instance.
Currently, the integration supports a ticket integration.
For any questions related to setting up the integration, please send mail to email@example.com.
You can sign up for a free trial of ONEiO from the following link: ONEiO Free Trial
Sending messages from ONEiO to Autotask
To communicate with Autotask first we would need to create an integration user.
Creating an integration user in Autotask
Add an API user to Autotask.
Admin -> Resources (User)
New -> New API user
Fill in the needed user details
- First Name (Integration Specific)
- Last Name (Integration Specific)
- Email Address (Integration Specific)
- Security Level - API User (system)
- Primary Internal Location (Integration Specific)
Generate a Key and Secret pair. These are used in the Username and Password fields in the ONEiO UI.
On API Tracking Identifier, select the option Integration Vendor, open the dropdown Integration Vendor and search for ONEiO - middleware. Add also a name for your application.
Depending on your integration you might adjust the Line of Business. We are not doing it in this example.
Press "Save & Close"
Next, we need to get the Resource ID of the integration user. This is used in the endpoint to prevent echoes in messaging.
Go to Admin -> Resources (User) and search for your integration user under "Resource Name". This brings up the integration user and shows its Resource ID.
With this information, we can now create our endpoint in ONEiO.
In the ONEiO endpoint UI, we have to set the following information.
- Autotask Base URL
- Integration User (Key)
- Password (Secret)
- Integration User Resource ID
You can find your Autotask Base URL by checking the Autotask PSA API zones and WSDL versions document. Look for the REST API section, and Find your zone's API URL for the REST API. Please, add just the main domain, suppressing the /atservicesrest.
Sending messages from Autotask to ONEiO
Autotask is a poller-based system and we poll information from Autotask by its base URL and a preset query. To start receiving tickets from Autotask please activate the poller and if needed adjust the query, in the "Entity types" tab of the endpoint UI.
Creating notes and attachments in the direction of Autotask requires a special message type which is already part of the endpoint configuration.
ONEiO offers template integration via rule robot if both of the integrated endpoints support it. Autotask rule robot configuration is available with the exception of handling inbound notes and time entry data. Example routing rules can be made available on request.