Connecting your Autotask to MSPbots enables our bots to pull in read-only user data and activates message alert and reporting bots, among other MSPbots functionalities. To set up the Autotask connection, you have to generate the API user and API keys, input the API keys into MSPbots, and configure Webhooks.
How to connect Autotask to MSPbots
1. Create an API User and Getting API Keys from Autotask.
-
- Log in to Autotask as an admin.
- Go to > Admin > Account Settings & Users.
- Click Resources/Users (HR) > Resources/Users.
- Click > New API User.
- Fill out the necessary fields under the First General area.
- Set the First Name to MSPbots.
- Set the Last Name to AI.
- Set the Email Address to any email address.
- Set the Security Level to the highest level to prevent sync and view permissions later.
- Next, generate the API keys under the Second General area.
- Click the Generate Key button to generate a user key.
- Click the Generate Secret button to generate a secret password.
Take note of the key and the secret because these may be inaccessible in the future.
- Select the vendor from the dropdown in the API Tracking Identifier section. Ensure that Integration Vendor is selected.
- Go through the list and select MSPbots.
- For the Line of Business field, follow these steps to move all available Division > Line of Business pairings from the Associated pane to the Not Associated pane. If all pairings are already in the Not Associated pane, please proceed to the next step.
- Select a pairing in the Associated pane.
- Click the button to move the pairing to the Not Associated pane.
- Repeat steps i and ii until there are no pairings left in the Associated pane.
- Check the Resource can view items with no assigned Line of Business option.
- Click Save & Close.
2. Enter the API keys from Autotask to MSPbots.
Now that you have generated the user and API key information, it's time to sync and share data.
-
- Navigate to your MSPbots app and click Integrations.
- Scroll down to Autotask and click on Config.
- Fill out the following in the Information section:
- For API User Name, enter the username (key) from Autotask.
- For API User Password, enter the password (secret) key from Autotask.
- Once both are entered, click Save and Sync. If set correctly, you'll get a message stating the synchronization was successful.
- If the input information is incorrect, you will be prompted with the following message: "500 INTERNAL_SERVER_ERROR - Internal Server Error at auto task remote server" When this happens, re-enter the correct username (key) or password (secret).
- If you encounter a data sync error with the message "The logged in Resource does not have adequate permissions to query this entity type," this means that the user does not have enough permissions. To resolve this, refer to the article "AutoTask Integration Error | The logged in resource does not have the adequate permissions to query this entity type."
3. Configuring and registering Webhooks
-
- Go to the Webhooks page.
- Configure Webhooks according to the Autotask documentation, then register the Webhooks interface on the MSPBots platform.
- Click the Register icon to complete the registration.
- Go to the Webhooks page.