<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 id="isPasted"><strong>In this guide we will cover:</strong></p><p><span style="font-size: 11pt;"><strong>- Connecting via the API</strong></span></p><p><span style="font-size: 11pt;"><strong>- Mappings</strong></span></p><ul style="margin-left: 20px ;"><li><span style="font-size: 11pt;"><strong>Custom Fields</strong></span></li><li><span style="font-size: 11pt;"><strong>Trouble Shooting Using the Developer Tools</strong></span></li><li><span style="font-size: 11pt;"><strong>Ticket Type</strong></span></li><li><span style="font-size: 11pt;"><strong>Email Rule</strong></span></li></ul><p><br></p><p>The commonly used RMM's will have detailed guides of how to integrate with Halo. This below guide goes over the general procedure for integrating with any RMM tool.</p><p><br></p><p>There must be a connection between the RMM and Halo, this is usually in the form of an API Key. So you will connect to the RMM from the integration page on Halo, whether you are connecting to Ninja, Datto, N-Able N-Central, etc... This will include a token/ secret for authenticating the connection. Once connected on both sides, the next step is to set up the mappings. The procedure for i.e. NinjaOne is to generate an API Key which creates a Key and a secret. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4Y2VjM2JhLTJlYzYtNGI5Ny1iZGRmLWExNjUwNDE2MzcxOCJ9.bkPpF7zS0_C1QhQgVb_VIBVEtf4BHAfJA8WovW_Bh9o" class="fr-fic fr-fil fr-dib" width="1222" style="width: 1224px; height: 234.277px;" height="234"></p><p><strong><span style="font-size: 10pt;">Fig 1. Generating an API Key on Ninja</span></strong></p><p><br></p><p><em><strong>Note:</strong></em><strong><em> It is vital to make sure you copy down the secret key as it will only be visible for a limited amount of time.</em></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Connecting to Halo</span></strong></p><p>Then going back over to Halo, the connection between the applications can be made by inputting the ID (API Key) and secret from the RMM into Halo on the integrations page. </p><p><br></p><p><em><strong>Note: </strong></em><strong><em>It is important to make sure the module for the integration has been enabled by clicking on the plus sign shown below, this applies to all integrations, not just RMM's</em></strong></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNmOWQzZDkwLTkzNTAtNGVjNy05MDk2LTc4ZmIzZGUzYWNhNyJ9.iQ-Q8sQydQ5zovLmmYaRD2YLnqEbIDiEhcZJxCYAVFM" class="fr-fic fr-fil fr-dib" width="455" height="220"></p><p><strong><span style="font-size: 10pt;">Fig 2. Enabling The Module</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Mappings</span></strong></p><p>To allow the assets in halo to sync with assets in the RMM, we must map the customers/ sites/ assets in Halo to the customer/ site/ assets in the RMM (some RMM's do not include customer mappings). If the name of the customer in the RMM is different from the name in Halo, then the field chosen to match on will have to be different as it must be a uniquely identifying field that is the same value across Halo and the chosen RMM.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE2ZGViN2Y4LTdlODUtNDkxOC05ZDUyLTFjYjU3YThiMDYxNSJ9.LHyIVxVVRI0VOPNZttHZFWj3jLB7jM6R-SHXsLOQ6gg" class="fr-fic fr-fil fr-dib" width="942" height="264"></p><p><strong><span style="font-size: 10pt;">Fig 3. Importing Assets</span></strong></p><p><br></p><p>Asset matching, before achieving the mapping of customers make sure to import customers before mapping the assets to that customer, or else all of the assets will end up in the unknown customer. Assets can be mapped directly to customers because it is a field on the asset import spreadsheet. To navigate to the import assets button, go to Configuration > Asset Management > General Settings and scroll to the very bottom. To get the sample spreadsheets when importing, the "Download Samples" button on the top left of the import screen can be used to download the asset import file along with many other import files</p><p><br></p><p><em><strong>Note:</strong></em><strong><em> This sample import folder only needs to be downloaded once and then it will be available for all different types of imports.</em></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjhmY2U4OWE0LWM5MWYtNGE4My05YmYxLWIxMGFkMzZlYTQ5ZiJ9.MZFqKrBDuqGQv0z0j-BSflOq58-TxcKieEXlHgqWsWg" class="fr-fic fr-fil fr-dib" width="405" height="132"></p><p><strong><span style="font-size: 10pt;">Fig 4. Download Samples Link</span></strong></p><p><br></p><p>The layout of the import spreadsheet for assets is shown below:</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjViOTlkMTI1LWZhNjktNDRiMi1iODBkLTI2NjU3NzNkYjE2MyJ9.lrtZiX4xoox2Y3h9ft5RL3UV6pEAiNdQ055RulNgM3Y" class="fr-fic fr-fil fr-dib" width="1208" style="width: 1210px; height: 84.1229px;" height="84"></p><p><strong><span style="font-size: 10pt;">Fig 5. Import Assets Spreadsheet</span></strong></p><p><br></p><p>Custom fields on Halo can be added to this by using the convention $CFvariablename so a custom field named CF3rdparty, would appear on the spreadsheet as $CF3rdparty.</p><p><br></p><p>If there is a certain field you are looking for to import, it can be found by using the developer tools on your browser by clicking Fn + F12 (If on a windows machine) or on Mac go into Safari's preferences (Safari Menu > Preferences) and select the Advanced Tab. Then the shortcut is Option + ⌘ + C (On Mac). Furthermore the data types on the spreadsheet need to be correct in order for the input to work, if it is a date in the input it should be a defined date time data type on the spreadsheet (The date field will vary depending on the area of Halo). If there are errors when importing, it is best to run the development tools whilst importing to see if an error is being displayed on the API, this is very useful for detecting data type errors on spreadsheets. Check the response tab to see what the response from the API was and check the payload tab to see what changes have been made on the screen.</p><p><br></p><p><strong><span style="font-size: 14pt;">Further Configuration</span></strong></p><p>Default asset group for assets, all assets must have certain types, all types must have certain groups. RMM’s can create new asset types, those options specify which group those assets are within. Field mapping table, if you don’t map a field the data wont be imported, if you match a field you must make sure the field is on the respective asset type or the asset wont be displayed. </p><p><br></p><p>Default site for new assets, this is the site new assets will exist within if assets have not been imported. Some RMM’s in more recent times have asset type mappings, either have one table as all of the fields to match, but some RMM’s such as IT Glue and ConnectWise RMM have an additional layer where you map asset types then a modal window pops open where you map fields per asset type.</p><p><br></p><p>The alert ticket type should be selected as the default as this is to show assets on the ticket. Make sure to choose the correct email rule type if it is an alert that is pulled in via email, i.e. if it is a ninja alert, make sure to choose the correct email rue type and that the email comes from the mailbox from ninja i.e. alert@ninja.com</p>
