Overview

ConnectWise is a Professional Services Automation (PSA) platform for companies that sell, service, and support technology. You can choose to integrate the x360Recover Remote Management Console (RMC) with the ConnectWise PSA tool.

When you do this, alerts that originate in x360Recover will be pushed to ConnectWise, allowing you to manage and monitor all events from one location. 

Note: To complete x360Recover RMC integration with the ConnectWise PSA tool, you will first need information related to the ConnectWise account being used.

Before you start the x360Recover RMC integration, you will need to complete the following tasks:

Obtain the API key Obtain ConnectWise account login details Obtain company account details for the target client site Obtain ConnectWise service board data (including service type and subtype) Obtain service priority setting

---

Security Permission Requirements 

ConnectWise REST API user accounts require certain security privileges in order to establish connection with ConnectWise and publish/ manage PSA tickets.

1. API user accounts should have Inquire permissions for:

• Company Maintenance
• Contacts
• Service Tickets 
• System/Table Setup
• Service Desk/Close Service Tickets

2. API user accounts should also have Add and Edit permissions to Service Tickets.

Please navigate to Security Roles/ Security Modules on the ConnectWise webpage and update the security permissions highlighted in the below screenshots:

Companies screenshot:

System/ Table set up screenshot:

Service Desk/ Close Service Tickets screenshot:

Instructions

You can configure PSA settings in the x360Recover RMC in two ways:  

1. Implement global (organization-wide) PSA integration (optional) 

Note: Even after you have implemented PSA settings at the organization level, you can always customize PSA settings for individual clients.

2. Customize individual client PSA integrations

 

---

To implement global (organization-wide) PSA integration with ConnectWise:

1. On the x360Recover Dashboard, click the Settings link. 

2. In the Organization Settings page, scroll down to locate the PSA Tool section, then click the Edit button:

3. Click the Configure Using drop-down menu to select your preferred PSA tool. For this example, select  ConnectWise.

The page expands to display configuration settings:

In the URL field, enter the URL address for ConnectWise. Format this URL as follows:      Correct: connectwise.com      Incorrect: www.connectwise.com      Incorrect: http://connectwise.com In the API Key field, enter the public API key generated in ConnectWise.  In the API Secret field, enter the private API key generated in ConnectWise. In MSP Company ID, enter the company name. In the Company ID field, enter the ID of the company.

Optionally, to configure global (organization-wide) advanced settings, enable the Advanced Settings toggle and configure all appropriate fields described below: 

In the Contact drop-down, select the contact person. In the Service Board drop-down, select the service board to which tickets must be sent. In the Service Type drop-down, select the type of service action to take. In the Ticket Priority field, enter the priority level of tickets that originate from BRC. Enable or disable Automatic Ticket Closure as per the business requirement In the Address Line 1 and Address Line 2 field, enter the client company address. In the City field, enter the client company city. In the State drop-down, select the client company state. In the Zip field, enter the client company ZIP code.

4. Click Save when you are finished. 

 

---

To configure or customize individual client PSA integrations with ConnectWise:

1. Click the Clients tab on the Dashboard.

2. Locate the desired client and click the Details button.

3. In the Client Details page, click the Settings button.   

4. In the Client Settings page, scroll down to locate the PSA Tool section, then click the Edit button

     Note: PSA integration can be temporarily disabled for individual clients in the Client Settings page.

5. Click the Configure Using drop-down menu to select your preferred PSA tool. For this example, select  ConnectWise.

The page expands to display configuration settings.

In the URL field, enter the URL address for ConnectWise. Format this URL as follows:      Correct: connectwise.com      Incorrect: www.connectwise.com      Incorrect: http://connectwise.com In the API Key field, enter the public API key generated in ConnectWise.  In the API Secret field, enter the private API key generated in ConnectWise. In MSP Company ID, enter the company name. In the Company ID field, enter the ID of the company.

Optionally, to configure advanced settings, enable the Advanced Settings toggle and configure all appropriate fields described below: 

In the Contact drop-down, select the contact person. In the Service Board drop-down, select the service board to which tickets must be sent. In the Service Type drop-down, select the type of service action to take. In the Ticket Priority field, enter the priority level of tickets that originate from BRC. Enable or disable Automatic Ticket Closure as per the business requirement In the Address Line 1 and Address Line 2 field, enter the client company address. In the City field, enter the client company city. In the State drop-down, select the client company state. In the Zip field, enter the client company ZIP code.

6. Click Save when you are finished.

 

---

Collect additional information

Obtain the API Key

You can obtain API information within the ConnectWise service. For the purposes of integrating ConnectWise with BRC, you will need to create a new API key. 

1. Log in to ConnectWise and open the System menu.
2. In the System menu, click the Members link.
3. In the Members page, click the API Members tab and then click the plus icon to create a new API Member.
• In the Member ID field, enter Axcient.
• In the Role ID field, make sure the role is configured with Add, Update, and Close tickets.
4. Click the Save button but do not close the window. After you click the Save button, you will be given access to the API Keys tab.
5. Click the API Keys tab and then click the plus icon to create a new API key.
• In the Description field, type x360Recover BDR.
• Click the Save button but do not close the window.
• Record the public key and private key before you close the window. You will not be able to view the private key again after this window is closed.

The image below details the location of the public key and private key fields (API Secret).

Obtain ConnectWise Login Information

The ConnectWise login information is created when first setting up the ConnectWise service. For the purposes of integrating ConnectWise with BRC,  you will need to enter the login information used to connect to ConnectWise into the appropriate fields. 

Obtain Client Information

To obtain the client information required to integrate with ConnectWise, you will first need to create a new company account for the target client site. 

To obtain the required client company information:

1. Log in to ConnectWise.
2. On the left-hand navigation menu, expand the Companies tab and select the Companies option.
3. In the Company Search page, enter the name of the target company.
4. When found, select the target company.
5. Record the following company information:
• Company address, which corresponds to the Address Line 1 and 2, City, State and Zip fields in the Axcient Web App.
• Territory field, which corresponds to the Location field in the Axcient Web App.
• Company ID field, which corresponds to the ID Number in the Axcient Web App.

Obtain Service Type and Subtype

The Service Type and subtype are determined by the ConnectWise login account. This ConnectWise account is associated with a specific Service Board, which must be configured as needed by the administrating user. (For more information regarding Service Boards, please refer to ConnectWise support.)

1. In the ConnectWise left-hand navigation menu, select System and then select Setup Tables.
2. In the Table column, enter the Service Board in the search field and press the Enter key.
3. On the Service Board List page, click on the appropriate Service Board.
4. To find the Service type, click the Types tab and enter one of the listed values in the Service Type field of the ConnectWise configuration page.
5. To find the Service subtype, click the Subtypes tab and enter one of the listed values in the Service Subtype field in the ConnectWise configuration page.

Obtain Priority

The service priority is determined by the ConnectWise login user. This ConnectWise account is associated with a specific Service Board, which must be configured as needed by the administrating user.  (For more information regarding Service Boards, please reference ConnectWise support.)

To obtain priority values:

1. On the ConnectWise left-hand navigation menu, select System  and then select Setup Tables.
2. In the Table column, enter SLA in the search field and press the Enter key. Click the SLA option when it displays.
3. On the SLA List page, select the appropriate SLA option. 
4. Enter one of the listed values in the Priority field in the ConnectWise configuration page.

 

579  |  801