<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><style>
p {
margin: 0;
}
span.fr-emoticon.fr-emoticon-img {
background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle;
}
span.fr-emoticon {
font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0;
}
blockquote {
border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px;
}
blockquote blockquote {
border-color: #00bcd4; color: #00bcd4;
}
blockquote blockquote blockquote {
border-color: #43a047; color: #43a047;
}
table.grid {
border-collapse: collapse;
}
table.grid td,
table.grid th {
border: 1px solid #ddd;
}
.fr-fic.fr-dib {
display: block; margin: 5px auto;
}
.fr-fic.fr-dib.fr-fir {
text-align: right; margin: 5px 0 5px auto;
}
.fr-fic.fr-dib.fr-fil {
text-align: left; margin: 5px auto 5px 0;
}
.fr-fic.fr-dii {
float: none; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fil {
float: left; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fir {
float: right; margin: 5px auto;
}
img.fr-dib.fr-fir {
margin-right: 0; text-align: right;
}
img.fr-dib.fr-fil {
margin-left: 0; text-align: left;
}
img.fr-dib {
margin: 5px auto; display: block; float: none;
}
img.fr-bordered {
box-sizing: content-box; border: solid 5px #CCC;
}
img.fr-shadow {
box-shadow: 10px 10px 5px 0px #cccccc;
}
img.fr-rounded {
border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;
}
</style><style>
p {
margin: 0;
}
span.fr-emoticon.fr-emoticon-img {
background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle;
}
span.fr-emoticon {
font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0;
}
blockquote {
border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px;
}
blockquote blockquote {
border-color: #00bcd4; color: #00bcd4;
}
blockquote blockquote blockquote {
border-color: #43a047; color: #43a047;
}
table.grid {
border-collapse: collapse;
}
table.grid td,
table.grid th {
border: 1px solid #ddd;
}
.fr-fic.fr-dib {
display: block; margin: 5px auto;
}
.fr-fic.fr-dib.fr-fir {
text-align: right; margin: 5px 0 5px auto;
}
.fr-fic.fr-dib.fr-fil {
text-align: left; margin: 5px auto 5px 0;
}
.fr-fic.fr-dii {
float: none; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fil {
float: left; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fir {
float: right; margin: 5px auto;
}
img.fr-dib.fr-fir {
margin-right: 0; text-align: right;
}
img.fr-dib.fr-fil {
margin-left: 0; text-align: left;
}
img.fr-dib {
margin: 5px auto; display: block; float: none;
}
img.fr-bordered {
box-sizing: content-box; border: solid 5px #CCC;
}
img.fr-shadow {
box-shadow: 10px 10px 5px 0px #cccccc;
}
img.fr-rounded {
border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;
}
</style><style>
p {
margin: 0;
}
span.fr-emoticon.fr-emoticon-img {
background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle;
}
span.fr-emoticon {
font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0;
}
blockquote {
border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px;
}
blockquote blockquote {
border-color: #00bcd4; color: #00bcd4;
}
blockquote blockquote blockquote {
border-color: #43a047; color: #43a047;
}
table.grid {
border-collapse: collapse;
}
table.grid td,
table.grid th {
border: 1px solid #ddd;
}
.fr-fic.fr-dib {
display: block; margin: 5px auto;
}
.fr-fic.fr-dib.fr-fir {
text-align: right; margin: 5px 0 5px auto;
}
.fr-fic.fr-dib.fr-fil {
text-align: left; margin: 5px auto 5px 0;
}
.fr-fic.fr-dii {
float: none; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fil {
float: left; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fir {
float: right; margin: 5px auto;
}
img.fr-dib.fr-fir {
margin-right: 0; text-align: right;
}
img.fr-dib.fr-fil {
margin-left: 0; text-align: left;
}
img.fr-dib {
margin: 5px auto; display: block; float: none;
}
img.fr-bordered {
box-sizing: content-box; border: solid 5px #CCC;
}
img.fr-shadow {
box-shadow: 10px 10px 5px 0px #cccccc;
}
img.fr-rounded {
border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;
}
</style><p><strong>In this guide we will cover:</strong></p><p id="isPasted"><strong>- What is the ScreenConnect Integration?</strong></p><p><strong>- Connecting <strong data-pasted="true">ScreenConnect </strong></strong></p><p><strong>- Generating Client/Site Mappings</strong></p><p><strong>- Asset Type Mappings and Asset Field Matching</strong></p><p><strong>- Remote Support</strong></p><p><strong>- Syncing with the Halo Integrator</strong></p><p><strong>- Common Issues</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the ScreenConnect Integration?</span></strong></p><p>ScreenConnect is a remote support tool used to connect onto the workstations of users whether it be internal or external support. </p><p><br></p><p><strong><span style="font-size: 14pt;">Connecting <strong data-pasted="true"><span style="font-size: 14pt;">ScreenConnect </span></strong></span></strong><strong><span style="font-size: 14pt;"> </span></strong></p><p>The first stage is to open your ScreenConnect and add the "Halo Integration" extension onto your extensions.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImI1ZDE5NjlmLTZiM2YtNDliNi1iNTA0LTZiZTc3NGM5YzI5NCJ9.zi7IFxBfms4p4i7UksTWoplM7JdtmqAKaYk3mBzPYhs" class="fr-fic fr-fil fr-dib" width="1058" style="width: 1058px; height: 397.433px;" height="397.433"></p><p><strong><span style="font-size: 10pt;">Fig 1. Halo Integration.</span></strong></p><p><br></p><p>The Halo instance URL and API Key can be added to the Halo Integration extension on ScreenConnect by clicking on the ellipse on the extension and adding the following credentials:</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjVhNzQ4ZTZlLWJmODktNGQ0Yy04MTNlLWQwZDU2ZDkyNTQ2YyJ9.JVKU8ej39yVRC--5m50bBmw7t15ODj04OdXFIU_LSwo" class="fr-fic fr-fil fr-dib" width="993" height="232"></p><p><strong><span style="font-size: 10pt;">Fig 2. Ellipse (...) on the integration.</span></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjA1NWVmZmYwLTlhMmYtNGZjMC05N2QwLTczMzNlNDQ4ODY5MCJ9.IF8gaAqgg48aKC9zpv5-lJHvYvJIirfp_ImzwO-QN00" class="fr-fic fr-fil fr-dib" width="1049" style="width: 1049px; height: 681.019px;" height="681.019"></p><p><strong><span style="font-size: 10pt;">Fig 3. Extension settings.</span></strong></p><p><br></p><p>The above mentioned credentials can be found on the ScreenConnect integration page on your Halo (Configuration > Integrations > ScreenConnect/ConnectWise Control).</p><p><br></p><p>The ScreenConnect URL would be: https://yourConnectwiseControldomain.screenconnect.com/App_Extensions/80f76e57-66d2-456a-9ed6-dff90e740009</p><p><br></p><p><em><strong>Note: </strong></em><strong><em>You must use /App_Extensions/80f76e57-66d2-456a-9ed6-dff90e740009 at the end of the URL not /extensions/</em></strong></p><p><br></p><p>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 ScreenConnect.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZiMTVmNDNlLTRkNzQtNDZhOC1iZTBhLTkxYTViYmNiMjM3MiJ9.M9SSPHCz0lIjLvYFpCMBEAfcwrjIrXsBtlpsLeWCS7I" class="fr-fic fr-fil fr-dib" width="1051" style="width: 1051px; height: 304.184px;" height="304.184"></p><p><strong><span style="font-size: 10pt;">Fig 4. URL and API key.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Generating Client/Site Mappings</span></strong></p><p><strong><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImVlYmI4NWU1LTg2ODgtNGRjNi05YTdhLWZlZWNmYWRiMjliMCJ9.9Y9PPIRgVizpv6IJPNjYleqiXRs4j31ayZA22iug-gA" class="fr-fic fr-fil fr-dib" width="1026" style="width: 1026px; height: 389.255px;" height="389.255"></strong><strong><span style="font-size: 10pt;">Fig 5. Client/Site mapping table.</span></strong></p><p><br></p><p>Pick the site and customers by clicking on add and adding to the table.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU3MDVkYjEwLWU0OGMtNDQ2NC1hYzE5LTBkYmRmYjAzNzg2NyJ9.XA4wBie1my_OKI734BhAc0R67ZtXhcctm4Do33fkupk" class="fr-fic fr-fil fr-dib" width="861" height="490"></p><p><strong><span style="font-size: 10pt;">Fig 6. Mapping popup.</span></strong></p><p><br></p><p>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 ScreenConnect ID, check out this video from ConnectWise on adding custom properties <a href="https://www.youtube.com/watch?v=KgtLfEkAdwM" rel="noopener noreferrer" target="_blank"><strong>here</strong></a>.</p><p><br></p><p>Custom properties can be mapped to ScreenConnect here.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjAxMGY3MTFhLTBmNDYtNDY0Ny04M2Y3LWZkYTYxYjZjZTVhNiJ9.Iuru8JMLy7ZxMbuj1IKLfyHUKuRvsBD0oCc3zArltoU" class="fr-fic fr-fil fr-dib" width="1040" style="width: 1040px; height: 262.769px;" height="262.769"></p><p><strong><span style="font-size: 10pt;">Fig 7. Custom property mappings.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Asset Type Mapping and Asset Field Matching</span></strong></p><p>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.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjNlYjMzOGIyLTJhMWQtNGFiOC05ZmFhLTE2MGFlMmY3OTlmOCJ9.QTcLKkQIIaEu2tbJ4pAi3ToOXNcavj4DTxMGzgdk55w" class="fr-fic fr-fil fr-dib" width="1052" style="width: 1052px; height: 382.928px;" height="382.928"></p><p><strong><span style="font-size: 10pt;">Fig 8. Asset type mappings and asset matching field.</span></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3MDNmN2EzLTQ2NTItNGUwZC04ZGMyLTg3MmUwZTc5NjJkMCJ9.j31HTAryOAGSGZY_d4cxTae8Yek67ZhiR-3jvxi2jOI" class="fr-fic fr-fil fr-dib" width="564" style="width: 564px; height: 331.31px;" height="331.31"></p><p><strong><span style="font-size: 10pt;">Fig 9. Field mappings.</span></strong></p><p><br></p><p><em><strong>Note: </strong></em><strong><em>In addition to mapping asset types, there is also an option to import all existing Halo assets from ScreenConnect.</em></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Remote Support</span></strong></p><p id="isPasted">You can use Remote Support functionality to send support session invite links to users on tickets. <strong><em>Note: This requires version 1.8 of the Halo Extension in ScreenConnect.</em></strong></p><p><br></p><p>After importing an asset, add it as a related asset on a ticket. This can be done when the "Asset" field is added to the field list of the ticket type. This will show a button to connect to the asset's associated ScreenConnect page, and clicking this will redirect you there to the join screen.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY0NjIzNTlkLWM4NmMtNGEzZS04Y2M3LWI1MTRkZjAxNjhjNSJ9.fcD_O84McHznODTK9o3bu1jxpdAD5349nePp33tVPOs" class="fr-fic fr-fil fr-dib" width="1088" style="width: 1090px; height: 480.468px;" height="480"></p><p><strong><span style="font-size: 10pt;">Fig 10. Remote support from a ticket.</span></strong></p><p><br></p><p>Variables with invite links can be emailed from the ticket, or added to the remote support variable configuration as below. This can be done using the $-REMOTEINVITE or $-LINKTOREMOTE variables, which will populate with the link once the email is sent. If using the remote support template, you can configure an action with the system use "Remote Support Invitation" to automatically send this.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZhM2RmOTZjLWZhZGUtNGFjOC1hY2RlLTlmOGQ4ZWNjZTQ1ZCJ9.I5tT6dja-IAw9pGqO39yG3MzqUbEThkq68-Gz7zCzXk" class="fr-fic fr-fil fr-dib" width="1088" style="width: 1090px; height: 418.143px;" height="418"></p><p><strong><span style="font-size: 10pt;">Fig 11. Configuration for remote support links and webhooks.</span></strong></p><p><br></p><p id="isPasted">You can also receive notes and time spent on a Remote session via a webhook from ScreenConnect, as seen above. Create an Event Automation in ScreenConnect, generate the webhook password above, and replace it within [YOUR_WEBHOOK_PASSWORD]. Be sure to "Allow inbound webhooks for this Integration" to receive these.</p><p><br></p><p><strong><span style="font-size: 14pt;">Syncing with the Halo Integrator</span></strong></p><p>The Halo Integrator can be enabled for the syncing of assets from Halo to ScreenConnect. The integrator will sync changes from Halo over to ScreenConnect, which allows for example assets to be continuously updated when changes are made. Additionally, assets can be deactivated in Halo when deleted on ScreenConnect by enabling the checkbox under the miscellaneous dropdown.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjYyNDliYjY5LTYwNjMtNDA2Mi04NDc2LWQxYzZiOWFlN2JlMSJ9.BxRMd4n1ShAcUnyo_docO11RP1fVW06AMTyOxUEqmUc" class="fr-fic fr-fil fr-dib" width="1037" style="width: 1037px; height: 307.303px;" height="307.303"></p><p><strong><span style="font-size: 10pt;">Fig 12. Integrator enabled.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Common Issues</span></strong></p><p>If the import is failing then ensure that the Session Filter (as below) is empty.</p><p><br></p><p><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjcyMDY3NTM5LTI3NTItNDliNC1hY2YwLThkNjMxMmVjMjFlNCJ9.gTaZDJmL6xiqQQ_dR5ZQMN98qTu-xlMoMGcxu6sfzL8" class="fr-fic fr-fil fr-dib" width="689" height="416"><strong><span style="font-size: 10pt;">Fig 13. Session group.</span></strong></p><p><br></p>
