HaloPSA

HaloPSA Guides

Documentation to assist with the setup and configuration of the HaloPSA platform

Guides > ConnectWise Control Integration

ConnectWise Control Integration

In this guide we will cover:

- Connecting ConnectWise Control

- Generating Client/Site Mappings

- Asset Type Mappings and Asset Field Matching

- Syncing with the Halo Integrator

- Common Issues



ConnectWise Control is a remote support tool used to connect onto the workstations of users whether it be internal or external support. 


Connecting ConnectWise Control 

The first stage is to open your ConnectWise Control and add the "Halo Integration" extension onto your extensions.


Fig 1. Halo Integration.


The Halo instance URL and API Key can be added to the Halo Integration extension on ConnectWise by clicking on the ellipse on the extension and adding the following credentials:


Fig 2. Ellipse (...) on the integration.


Fig 3. Extension settings.


The above mentioned credentials can be found on the ConnectWise Control integration page on your Halo (Configuration > Integrations > ConnectWise Control).


The ConnectWise Control URL would be: https://yourConnectwiseControldomain.screenconnect.com/App_Extensions/80f76e57-66d2-456a-9ed6-dff90e740009


Note: You must use /App_Extensions/80f76e57-66d2-456a-9ed6-dff90e740009 at the end of the URL not /extensions/


In order to connect the API Key use the generate and copy buttons to generate a new key and then copy it to clipboard and paste it into the respective box on ConnectWise Control.


Fig 4. URL and API key.


Generating Client/Site Mappings

Fig 5. Client/Site mapping table.


Pick the site and customers by clicking on add and adding to the table.


Fig 6. Mapping popup.


The mappings can then be generated once you are content with the mappings listed on the table. Custom Properties can be added and then mapped to by using the corresponding ConnectWise ID, check out this video from ConnectWise on adding custom properties here.


Custom properties can be mapped to ConnectWise Control here.


Fig 7. Custom property mappings.


Asset Type Mapping and Asset Field Matching

The next section to complete on the integration page is adding the mappings for the asset types, navigate to this table and add the mapping, the matching fields should be a unique identifier.


Fig 8. Asset type mappings and asset matching field.


Fig 9. Field mappings.


Note: In addition to mapping asset types, there is also an option to import all existing Halo assets from ConnectWise Control.


Syncing with the Halo Integrator

The Halo Integrator can be enabled for the syncing of assets from Halo to ConnectWise Control. The integrator will sync changes from Halo over to ConnectWise Control, which allows for example assets to be continuously updated when changes are made. Additionally, assets can be deactivated in Halo when deleted on ConnectWise by enabling the checkbox under the miscellaneous dropdown.


Fig 10. Integrator enabled.


Common Issues

If the import is failing then ensure that the Session Filter (as below) is empty.


Fig 11. Session group.


Popular Guides