<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><strong>- What is the Domotz Integration?</strong></p><p><strong>- Creating an API Key</strong></p><p><strong>- Halo Configuration</strong></p><p><strong>- Halo Integrator</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the Domotz Integration?</span></strong></p><p>Domotz can be integrated with Halo to import agents and assets, and automate syncing of assets between the two platforms. </p><p><br></p><p><strong><span style="font-size: 14pt;">Creating an API Key</span></strong></p><p id="isPasted">This integration requires some configuration within your Domotz portal before the integration configuration can be completed in the Halo Application. To communicate with Domotz via its API, an API Key must be generated in Domotz. To do this, navigate to your Domotz Portal and then to Settings > API Keys, or click here .</p><p><br></p><p>You can then click the Create an API Key, give it a name and then make sure you copy your API Key to the API Key field in the Halo Domotz configuration and the Endpoint URL to the Halo Application URL field in the Halo Domotz configuration.</p><p><br></p><p>You can then test your credentials to ensure Halo has a connection to your Domotz API.</p><p><br></p><p><strong><span style="font-size: 14pt;">Halo Configuration</span></strong></p><p>Every field on the Domotz configuration page marked with a red * configuration must be filled out in order to facilitate the integration.</p><p><br></p><p><strong><span style="font-size: 12pt;">Agent Import Configuration </span></strong></p><p>You <strong>must </strong>import your Domotz Agents before importing your devices as devices are found based off of Agents.</p><p><br></p><p>The following fields allow you to set a default Asset type and site for your Domotz Agents:</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjhjNzNkYTNiLTk0NGEtNGRkYS1iMGUyLWI5MWM4MGQ2ZmY3MSJ9.JSRoysFb6hXiRl8dUPookBu9dJGfebmcC-GMdVQ6e0E" class="fr-fic fr-fil fr-dib" width="1213" style="width: 1215px; height: 271.578px;" height="272"></p><p><strong><span style="font-size: 10pt;">Fig 1. Device type and site.</span></strong></p><p><br></p><p>For simplicity, we recommend creating a new Asset Type specifically for your Domotz Agents.</p><p><br></p><p>You could then add this Asset type to a group in order to keep your Asset view organised:</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjMwYTY0ZTEwLWQxZjAtNDlkOC05ZGM3LTg1MzEzZTNlYzFhNCJ9.P77MaoeZuZStN3MYPRIRYJm0D4x8H3uoL7OkGWtYNhM" class="fr-fic fr-fil fr-dib" width="1215" style="width: 1217px; height: 562.613px;" height="563"></p><p><strong><span style="font-size: 10pt;">Fig 2. Imported assets.</span></strong></p><p><br></p><p>You can then fill out any field mappings you may want for these Agents. These are not necessary and will not impact importing of your devices.</p><p><br></p><p>Finally you can use the "Import Agents" button to import your Domotz Agents.</p><p><br></p><p><strong><span style="font-size: 12pt;">Device Importing</span></strong></p><p>You can now proceed with configuring and importing your devices into Halo.</p><p><br></p><p>You can map Device types from Domotz to Asset Types in Halo. Any devices that are imported which do not have an associated mapping will use the Default Asset type which can be set below the type mappings.</p><p><br></p><p>There is not customer matching for Domotz Devices so you should set a default site for assets to be imported at. If you change the site of an asset after importing, it will remain at that site after subsequent imports.</p><p><br></p><p>You can then map Domotz device fields to Asset fields in Halo.</p><p><br></p><p>Finally you can import your devices using the "Import Assets" button.</p><p><br></p><p>A button will appear at the top of each asset that links to its corresponding Domotz asset URL. This will only show if both the agent and asset are linked and imported correctly.</p><p><br></p><p><strong><span style="font-size: 14pt;">Halo Integrator</span></strong></p><p>The device import can be run on a schedule using the Halo integrator.</p><p><br></p><p>You must have an up to date version of the Halo Integrator and ensure you enable the integration for the Halo Integrator on the Domotz configuration page.</p><p><br></p><p>Finally in the miscellaneous settings, you can allow devices in Halo to be made inactive if they are deleted from Domotz. Please note this will only have an effect if the import is through the Halo Integrator.</p>
