<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><strong>- What is the Hopewiser Integration?</strong></p><p><strong>- Enabling the Hopewiser Module</strong></p><p><strong>- Connecting to Hopewiser</strong></p><p><strong>- Using the Address Lookup on a User</strong></p><p><strong>- Using the Address Lookup on a Ticket</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the Hopewiser Integration?<br></span></strong></p><p>The Hopewiser integration can be used to search addresses from Hopewiser on a user in Halo or on an address ticket field, helping to ensure the addresses you set are entered correctly. It is connected via an API token created within Hopewiser.</p><p><br></p><p><strong><span style="font-size: 14pt;">Enabling the Hopewiser Module</span></strong></p><p>In Configuration > Integrations > Miscellaneous, you will find the Hopewiser module. Hover over it, and click the plus (+) to enable it.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjViZjk0YzQzLWMyZDktNDIwOS1hYWQ4LTY3YjBhYTdjYjEyMiJ9.kOe9Kdr_fVFucLTcpfk4Cc_pDsvbTgwL5a4m28i0OKw" class="fr-fic fr-fil fr-dib" width="525" height="238"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enabling the Hopewiser module.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Connecting to Hopewiser</span></strong></p><p>In Hopewiser, login to your portal and click "Create Token" on the home screen. You will be taken to this page, where you can view a list of tokens, and create a new one. Click "Create Token" here.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE5ZjgyYjY3LTljOWQtNGIxMy05ZWNlLTNkMjIwNTdhNmViMyJ9.V8zzG-SHfHCsZUFuw5z7viQEsF0mXcjcjqmpYmtSNVs" class="fr-fic fr-fil fr-dib" width="1218" style="width: 1220px; height: 340.742px;" height="341"></p><p><strong><span style="font-size: 10pt;">Fig 2. Token list in Hopewiser.</span></strong></p><p><br></p><p>A popup will show to set a username, password, and default address reference for the token. Set these, and make note of the username and password.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE1NmIxOTdiLTVkNTktNDAxYi1hNmRiLTNmY2NlNzVmZGUzOCJ9.qIiiA475NPUgW-4oKrGrlfqjEa44C_fMV15jSENBJZE" class="fr-fic fr-fil fr-dib" width="489" height="363"></p><p><strong><span style="font-size: 10pt;">Fig 3. Creating a token in Hopewiser.</span></strong></p><p><br></p><p>After clicking "Submit", another popup will show that the token has been created.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjU5MmFlZjhiLWM0ZTEtNGVhZi1iMWNjLWVlNGI5MDU4NjZkNyJ9.dItnIrhGiEQI1Y4AK2xEfqKhtzmViMNBFgUyy2NL8iE" class="fr-fic fr-fil fr-dib" width="402" height="200"></p><p><strong><span style="font-size: 10pt;">Fig 4. Token creation popup in Hopewiser.</span></strong></p><p><br></p><p>Back in Halo, click into the Hopewiser module. Enter the username and password you previously made note of in the corresponding fields at the top of the page. The "Master Address File" dropdown can then load the address references from Hopewiser.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZhZTcxNDQwLWU4MjktNDEzMi1hMDU1LTlhNGIxMmI5OWE3MCJ9.vGzqym_YSliSGo-jtdoOMG5lkhHUih7hOlz6N1a2h9k" class="fr-fic fr-fil fr-dib" width="1223" style="width: 1225px; height: 259.479px;" height="259"></p><p><strong><span style="font-size: 10pt;">Fig 5. Setup in the Hopewiser module.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Using the Address Lookup on a User</span></strong></p><p>Choose a user within a customer/site, and in the "Details" tab, scroll until you see the "Addresses" dropdown. Upon expansion of this dropdown, a table will show. Click "Add".</p><p><br></p><p><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjgzODQ5OWQ2LTg1NTgtNDIyMC1iOWMzLWM5YjkzZjVmZTQ4OCJ9.ZGJtl-hqbulM_dzOm_gb3FK6HdVTFa_BAfm0wf0lDcE" width="1218" height="390" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; text-align: left; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; width: 1220px; height: 390.339px; max-width: none !important;" id="isPasted" class="fr-fil fr-dib"><strong><span style="font-size: 10pt;">Fig 6. Addresses table on a user.</span></strong></p><p><br></p><p>A popup will then show to set an address. Two new fields will now show: "Address Search" and "Address Search Results".</p><p><br></p><p>Upon entering a phrase into the "Address Search" field, click "Search". The "Address Search Results" field will then show a dropdown list of addresses that fit that criteria. Choosing an address within that list will also then auto-fill the address lines underneath.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImYyNjc0YTY3LWEwYTctNDE4NC1iMzZjLWE2NDlmNmIwZjkzYSJ9.Xmm0jq37fHhYXpooVjiQiC73ZutB24B4g0qfB7F6jT4" class="fr-fic fr-fil fr-dib" width="710" height="834"></p><p><strong><span style="font-size: 10pt;">Fig 7. Auto-filled address based on the address search.</span></strong></p><p><br></p><p>When tickets are logged against that user, it will then show that address in the "End-User details".</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjczZTM0YTliLWUyNjMtNDQzYS04OTE2LTYzODA1YTRhMmQ1OSJ9.5rmIwiAAaTdgN_ewXLHkBTBoc7p5SR6qFBe7aW7hvJg" class="fr-fic fr-fil fr-dib" width="221" height="496"></p><p><strong><span style="font-size: 10pt;">Fig 8. Contact Address on a ticket.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Using the Address Lookup on a Ticket</span></strong></p><p>The address lookup can also be used on the new ticket screen. First, the "New ticket address field input" dropdown must be set to "Hopewiser Address Search" in Configuration > Users > General Settings > General Settings.</p><p><br></p><p><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjI3Yzc1ODRhLTA1YzItNDYyMi1hNTIyLTVkMDg1NDY0YTc4MiJ9.8ZQJYZgFEY-QoMHKPsEiCLxA1HK9x0pz3xYwgpP-bs4" width="242" height="75" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; text-align: left; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; max-width: none !important;" id="isPasted" class="fr-fil fr-dib"></p><p><strong><span style="font-size: 10pt;">Fig 9. New ticket address field input.</span></strong></p><p><br></p><p>When creating a ticket, any ticket type that has the "Address" field added to the field list will show the below. Whilst the address will auto-populate from the user, the address search can also be used in the same way here. Upon searching a string, a dropdown will show to select the address. After selection, the fields will populate with the address like with the user search.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQyYjU1ZTU1LTFiMmUtNDNkZS05NmM1LWEwZGE0MTNjMjUzMyJ9.dQVv8T2rMl3xlIj6c2UWYhDPFUf022ldeHWGvvvwTB4" class="fr-fic fr-fil fr-dib" width="1213" style="width: 1215px; height: 477.201px;" height="477"></p><p><strong><span style="font-size: 10pt;">Fig 10. Address search on the new ticket screen.</span></strong></p><p><br></p>
