<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><span style="font-size: 11pt;">In this guide we will cover:</span></strong></p><p><span style="font-size: 11pt;"><strong>- What are Users?</strong></span></p><p><span style="font-size: 11pt;"><strong>- Creating Users Manually<br></strong></span></p><p><span style="font-size: 11pt;"><strong> - Customers Area</strong></span></p><p><span style="font-size: 11pt;"><strong> - New Ticket Screen</strong></span></p><p><span style="font-size: 11pt;"><strong> - New Call Screen</strong></span></p><p><span style="font-size: 11pt;"><strong> - Changing End-User</strong></span></p><p><span style="font-size: 11pt;"><strong> - Converting from an Opportunity</strong></span></p><p><span style="font-size: 11pt;"><strong>- Creating Users via Portal Registration</strong></span></p><p><span style="font-size: 11pt;"><strong>- Create Users from Anonymously Logged Tickets </strong></span></p><p><span style="font-size: 11pt;"><strong>- Create Users when an Email cannot be matched to a User</strong></span></p><p><span style="font-size: 11pt;"><strong>- Create Users from a CSV/XLS Import</strong></span></p><p><span style="font-size: 11pt;"><strong>- Create Users from an Integration Import</strong></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><strong>Admin Guides:</strong></span></p><ul style="list-style-type: disc;"><li style="font-weight: bold; font-size: 11pt;"><a href="https://usehalo.com/haloitsm/guides/1415" target="_blank" rel="noopener noreferrer" style="font-size: 11pt;"><strong>Users</strong></a></li></ul><p><span style="font-size: 11pt;"><strong><br></strong></span></p><p><span style="font-size: 11pt;"><strong>Related Guides:</strong></span></p><ul><li style="font-weight: bold; font-size: 11pt;"><a href="https://usehalo.com/haloitsm/guides/866" target="_blank" rel="noopener noreferrer" style="font-size: 11pt;"><strong>Importing Data</strong></a></li></ul><p><br></p><p><strong><span style="font-size: 14pt;">What are Users?</span></strong></p><p>Users are the people who raise Tickets in Halo, and they each have a User account associated to a Client/Customer. Agents will also have a User account associated with them.</p><p><br></p><p>A User account is used to access the Self-Service Portal, and this guide will cover ways these accounts can be created.</p><p><br></p><p><em><strong>Note: Ensure the Agent permission "Users Access Level" is set to "Read and Create" or above.</strong></em></p><p><br></p><p id="isPasted"><strong><span style="font-size: 14pt;">Creating Users Manually</span></strong></p><p>Users can be manually created within a few areas of the system. All follow the same process of entering the basic information into Fields:</p><p><br></p><ul><li style="font-weight: bold;"><strong>Details Tab:</strong><ul style="list-style-type: disc; font-weight: initial;"><li>Username (Prefills First Name and Surname automatically)</li><li>Site</li><li>Email Address(es)</li><li>Telephone Number(s)</li><li>Address(es) - As of v2.238+, addresses created here can also be set against the Site on creation using the checkbox "Copy to Site address"</li></ul></li><li style="font-weight: bold;"><strong>Preferences Tab:</strong><ul style="list-style-type: disc; font-weight: initial;"><li>Email/Marketing Settings</li></ul></li><li style="font-weight: bold;"><strong>Permissions Tab:</strong><ul style="list-style-type: disc; font-weight: initial;"><li>Web Access Level (Whose Tickets that User can access within the Self-Service Portal. If set to "No Access", they will not be able to log in at all)</li></ul></li></ul><p>You can also set a Users Preferred Name and Middle Name. You can set this preferred name to be the name which shows on the ticket details by selecting the relevant option in the "User names to display in dropdown" field, found in Configuration > Users > General Settings. These new names can be pulled into <a href="https://usehalo.com/haloitsm/guides/2408" target="_blank" rel="noopener noreferrer">Email Templates</a> using the variables $-PREFERREDNAME, and $-MIDDLENAME. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFmYTkwMTEyLTYwODYtNGVmOS1hYTdiLTkyN2E4NmQ1OGUyMiJ9.I-phwDVgxQj9B9JUWXTy0B9qQwoc5LsbmvZEcR0P5RI" class="fr-fic fr-fil fr-dib" width="579" height="633"></p><p><strong><span style="font-size: 10pt;">Fig 1. Creating a new User manually</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Client/Customers Area</span></strong></p><p>The first area this can be done is within the Client/Customers Area.</p><p><br></p><p>A similar process can also be followed for anywhere a list of Users is visible, such as within the Client/Customer profile > Sites & Users tab.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImIyYzA5NGE4LTRjZDgtNGFjNi04MWVlLWY4MWM5MWY3ZmJmMSJ9.X8yVlgIoTUi0xqke6_gPchYKZONe5LQI1WSIIGySn30" class="fr-fic fr-fil fr-dib" width="1217" style="width: 1219px; height: 575.444px;" height="575"></p><p><strong><span style="font-size: 10pt;">Fig 2. Creating a User in the Client/Customer Area</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">New Ticket Screen</span></strong></p><p>In Configuration > Users > General Settings, enable the below option.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjJjMDc1YmY0LTgwYTQtNDA4ZC05YTVlLTYwODc5MTEyYTdkYSJ9.rnnopm7-Y6AN68a-9eguT8KT-6oWmDXq7auc_NMHtIQ" class="fr-fic fr-fil fr-dib" width="345" height="34"></p><p><strong><span style="font-size: 10pt;">Fig 3. Enable User creation on the New Ticket screen</span></strong></p><p><br></p><p>When viewing the New Ticket screen and selecting a User, an additional option will show in the dropdown; selecting this will show a popup to enter the information and create the User.</p><p> </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE4MjJjN2M2LTE0OTktNDQxNS05ODEzLWJjODM0MDI1NmNiNyJ9.nYFoLWm_pXizlRNbxvCM3I74Cd93EzpoU_DlnyRmCfM" class="fr-fic fr-fil fr-dib" width="1213" style="width: 1215px; height: 585.652px;" height="586"></p><p><strong><span style="font-size: 10pt;">Fig 4. Creating a User on the New Ticket screen</span></strong></p><p><br></p><p>There is also the additional option in Configuration > Tickets > General Settings to create a User when a Username is set but General User is selected.</p><p><br></p><p><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjUyMTlkMjUxLWMyZGItNDJkNy1iN2FiLTkxMGJhMTM2MGRkZSJ9.RLFCrDDuoAHw2g449rvwYY4EsAnRL_2Au-7237fqls0" width="534" height="60" 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 5. Enable User creation when filling in General User details</span></strong></p><p><br></p><p>When completing the User details field when a Ticket is raised against the General User, a new User will be created with these details against the Client/Customer and Site of the General User.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJkODhiZDBlLTdlNDctNGMyZS04ZjY4LTlhNzcxODlmNmE5OCJ9.8vP1bN5O_bPbxZlthDJ_aTaVGfxr-ukckAaLuDojpwc" class="fr-fic fr-fil fr-dib" width="1217" style="width: 1219px; height: 560.397px;" height="560"></p><p><strong><span style="font-size: 10pt;">Fig 6. Creating a User from the General User details</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">New Call Screen</span></strong></p><p>If the New Call screen is opened, whether from the UI or an integration, you can create a new User when matching the Client/Customer to the call or changing the previously matched User.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjhhNzgxNzllLTdhOTItNDI3MS1iZjFlLTUyYTNjNjU1YTQ5MCJ9.eL3TMljSVT1OOlKJ49u1-C2ZesPqnflUI6YbP-YUipQ" class="fr-fic fr-fil fr-dib" width="397" height="358"></p><p><strong><span style="font-size: 10pt;">Fig 7. Matching a Client/Customer on the Call screen</span></strong></p><p><br></p><p>Clicking this will show a popup to either select an existing User, or create a new one.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJmMTVlODNhLWZmYzktNGZhMC04OTI3LTczMzMzNTJlNzk0MyJ9.uaUB0zWr-TF3ACyyNwTmciIzAIDMIiXmqc_H2GgTDLw" class="fr-fic fr-fil fr-dib" width="715" height="332"></p><p><strong><span style="font-size: 10pt;">Fig 8. Creating a User from the New Call screen</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Changing End-User</span></strong></p><p>In Configuration > Users > General Settings, enable the below setting.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZhYzZkMWQ1LTA1YjMtNGQ0Zi05Y2U0LWQ4OTE0YjU3MDg2MyJ9.bURM4x8POn-_DBtMGiK7r3NIgV9ui_eiRb7nvyIiqmg" class="fr-fic fr-fil fr-dib" width="337" height="31"></p><p><strong><span style="font-size: 10pt;">Fig 9. Enabling User creation when changing User</span></strong></p><p><br></p><p><strong><em>Note: This option can only be used when changing the Site/User against a Ticket using the below popup, which can be accessed from the "..." > Change Site/User. It cannot be used when changing the User directly within the End-User details.</em></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM1MmViMzlhLWM1OTYtNDAwOC04NmEzLWI4MDVmMGFiNzgyMiJ9.BkBjpl6oceR_3qBvN0UOHOTZwE6pvV4cMKByLekG8k0" class="fr-fic fr-fil fr-dib" width="316" height="543"></p><p><strong><span style="font-size: 10pt;">Fig 10. Change Site/User option</span></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM3ZWI5NTRlLWMzMDMtNDc0NC04YjllLTUyNDM3YzQxYWU2OCJ9.2gyvh_wSUa-c0ClS65AfOa3zv0aDVsFAXuylW65Vjd4" class="fr-fic fr-fil fr-dib" width="709" height="290"></p><p><strong><span style="font-size: 10pt;">Fig 11. Creating a User when changing the End-User of a Ticket</span></strong></p><p><br></p><p>If you wish to force your Agents to use this view, and thus allow new User creation here, enable the below in Configuration > Tickets > General Settings. This means they will not be able to change the End-User from the End-User details on the Ticket, only from the "..." option.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM3OTRmM2QwLWJhOWQtNGRmZC1hZDU2LTU2OGZjNTY2NGY5ZiJ9.tRw5wWy05Vm4VKCPJzzyNdDe_ZIyng0v88ie1ZIPcHs" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 12. Force use of "..." > Change Site/User to change the End-User of a Ticket</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Converting from an Opportunity</span></strong></p><p>If you are utilising the Sales/CRM functionality, a Contact or Prospect can be converted to a User from the Opportunity Ticket.</p><p><br></p><p id="isPasted">If using Contacts, the conversion option will appear like below. The Contact will be converted to a User, and the Opportunity/Company to a Customer.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImRlY2ZjNThjLWRmYTgtNGRkNS05ZDFiLWI0ZWY3NWViYjg0MCJ9.SL8JoF1PfwqJp8oy0Dt35Fl4wpKUqWOUtvOKJsXj-e4" class="fr-fic fr-fil fr-dib" width="1215" style="width: 1217px; height: 686.043px;" height="686"></p><p><strong><span style="font-size: 10pt;">Fig 13. Converting a Contact to a User</span></strong></p><p><br></p><p>If "Use Accounts and Prospects for Opportunities" is enabled in Configuration > Sales, the conversion option will appear like below. The Prospect will be converted to a User, and the Account to a Customer.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImYyMmVhMTI5LTk4ZDYtNDE0Zi04ZmFiLWYyYzBmMGU0ODgwMSJ9.g3vTcUZudrE2vOKnX9xO0EkN62XbCt8ArGXY_Nu0kjM" class="fr-fic fr-fil fr-dib" width="1215" style="width: 1217px; height: 689.43px;" height="689"></p><p><strong><span style="font-size: 10pt;">Fig 14. Converting a Prospect to a User</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Creating Users via Portal Registration</span></strong></p><p>In Configuration > Self Service Portal, you can allow Users to register an account from the Self-Service Portal login screen. Upon enabling, you will need to set a default Site for these new Users to be created within.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU0MzdhNTc2LTI2MTAtNDdiZC05Yjk5LWJhYzE1NDNhM2MwYyJ9.G5OpY4avc-kiCy7M8e_T30S2ZPC2t5HHZROmzYE8R3U" class="fr-fic fr-fil fr-dib" width="287" height="116"></p><p><strong><span style="font-size: 10pt;">Fig 15. Enable User creation from the Self-Service Portal</span></strong></p><p><br></p><p>This option will then appear on the Self-Service Portal login screen.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImVkMDE2NjAwLTAwNzAtNDQ4ZS1iOTFlLThhMzA0NTcyODRiNiJ9.mNZ9DUcwjnXneTOUakQLhlGzI9qxxH1mMQnA-Y-1UX4" class="fr-fic fr-fil fr-dib" width="502" height="685"></p><p><strong><span style="font-size: 10pt;">Fig 16. Creating User account from the Self-Service Portal</span></strong></p><p><br></p><p>Clicking this will then allow the User to create an account by entering their name and email address.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQ4ZDQwY2FkLTQ1NTAtNDY1Ni05NGVkLTE3NTRkNTkwZTBhNCJ9.hZsoCD6hdTC9AH8xFKJGwwiWkpzf0AG_ir8fa1_qaSs" class="fr-fic fr-fil fr-dib" width="416" height="338"></p><p><strong><span style="font-size: 10pt;">Fig 17. Entering User details</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Create Users from Anonymously Logged Tickets </span></strong></p><p><span style="font-size: 11pt;">When allowing tickets to be logged anonymously, users can be created using the contact details given for these anonymously logged tickets. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">To ensure contact details can be given for the anonymous tickets ensure "Anonymous User" under Configuration > Self Service Portal is not set but "Anonymous User Site" is set. The site chosen will be the site new users will be created under. </span></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM0NDg4MGFjLTMyMzctNDAyMy04MjdlLTU5ZDA5MGQxYzEzNiJ9.5VbFK2q3zNGxCvL3Ydz0-LThgqjFMCkzvMIb6qToW1E" class="fr-fic fr-fil fr-dib" style="width: 1780px; height: 525.78px;" width="2185" height="646"></p><p><strong><span style="font-size: 10pt;">Fig 18. Set Anonymous User and Site</span></strong></p><p><br></p><p><span style="font-size: 11pt;">Also ensure "Hide the contact information fields when logging anonymously" is disabled against the ticket type. This will ensure when tickets of this type are being logged anonymously, contact details can be entered for the ticket.</span></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjJjYzZjNDU1LTVkYTMtNGM0ZC1iNDdkLTc4MjU0OGFkNGY1MSJ9.PZ0j6Zkl1BB2ZDVpzchFosysjXghTZg8n1z3TAZ3F7Q" class="fr-fic fr-fil fr-dib" width="1012" style="width: 1014px; height: 502.356px;" height="502"></p><p><strong><span style="font-size: 10pt;">Fig 19. Disable Hiding the Contact information for tickets of this type </span></strong></p><p><br></p><p><span style="font-size: 11pt;">Now, a "Contact Details" section will show when tickets of this type are being logged in the portal.</span></p><p><strong><span style="font-size: 10pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc5NWM4MDM4LWExNGEtNDJlYi1hZDFmLWMzOTJjMGRhZjdlMCJ9.Jd2mWtfKn3_ExSd13secimko0FnEaznTCox0lwbBwL4" class="fr-fic fr-fil fr-dib" width="1683" style="width: 1685px; height: 851.223px;" height="851"></span></strong></p><p><strong>Fig 20. Contact Details for Ticket</strong></p><p><strong><br></strong></p><p><br></p><p><span style="font-size: 11pt;">The details entered here will be used to create a user account. </span></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE4Y2Q1YzE3LTBlNTEtNGFjMC1hOThkLWE5YjE0OWIyNDk3OSJ9.ZVrOmbWDnqjB6DaKvoRW30tx2YKpK4wojzbyj2SS0D8" class="fr-fic fr-fil fr-dib" width="1109" style="width: 1111px; height: 510.413px;" height="510"></p><p><strong><span style="font-size: 10pt;">Fig 21. New user account</span></strong></p><p><br></p><p>From v2.238+ if any user custom fields are also added to the ticket type, the data entered into these will also be added to the newly created user account. Allowing you to gather and store custom information about anonymous users. </p><p><br></p><p><strong><span style="font-size: 14pt;">Create Users when an Email cannot be matched to a User</span></strong></p><p>In Configuration > Email > General Settings, you can set a new User to be created if the email address does not match an existing User.</p><p><br></p><p>This is overridden by the setting of the same name in Configuration > Email > Mailbox Setup > Incoming tab.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg5YzVhZDQwLTA5YjUtNDAzZi05MjNlLTEyYjM0MjM3ODZhNiJ9.wtX8_zH9XeeupfxSM-JHl8Q2Mui5Ovftsqr-4SoMV7o" class="fr-fic fr-dii"><br></p><p><strong><span style="font-size: 10pt;">Fig 22. Enable User creation from unmatched emails.</span></strong></p><p><br></p><p>A new User has been created under the default Client/Customer and Site set in Configuration > Tickets > General Settings, and the Username will come from the name set against that email address.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjcyMjdhOThlLTk5YzItNGUyZS05NTIzLWU1NjRiY2EyY2Q0MiJ9.ZBgEBnx_s5lY9fW7JgbFscCwmsP9qus1zW-mtZy7Zqk" class="fr-fic fr-fil fr-dib" width="1210" style="width: 1212px; height: 389.244px;" height="389"></p><p><strong><span style="font-size: 10pt;">Fig 23. New User created from email.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Create Users from a CSV/XLS Import</span></strong></p><p>Users can be created in bulk by importing from a spreadsheet. In Configuration > Users > General Settings, you will find options to set the unique identifier, and import a spreadsheet. </p><p><br></p><p>Clicking "Import Users" will bring up the import screen to upload a spreadsheet. If you exit out of this upload popup, the option to "Download Samples" will show. Clicking this will download a ZIP file of all the default import spreadsheets, including one for Users with the appropriate header names.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImYyZDUyZDBkLTlhMDMtNGM0Yy04Mjc5LTU5YThhZWIyYWRhMCJ9.fLf5xwTniv96dEPMvFTiYvL3yPfEi1zvKTEp1AEAYks" class="fr-fic fr-fil fr-dib" width="708" height="160"></p><p><strong><span style="font-size: 10pt;">Fig 24. CSV import configuration.</span></strong></p><p><br></p><p>You will need the name of the User, and the assigned Client/Customer and Site at minimum. These Client/Customers and Site will need to already exist in your system, they cannot be created via this import. They can however, be imported through a separate spreadsheet using the "Import Clients/Customers & Sites" button in Configuration > Users > General Settings before importing the Users after.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc5ODJiOGEwLTZiNjYtNDczMC04MDRlLTdhY2Q2OGMwZWZmMiJ9.nib6jGem8GqGNvetEAEA-w3XbVPw7nsHaFURvU2z8zk" class="fr-fic fr-fil fr-dib" width="1215" style="width: 1217px; height: 41.4147px;" height="41"></p><p><strong><span style="font-size: 10pt;">Fig 25. Example import spreadsheet.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Create Users from an Integration Import</span></strong></p><p>Multiple integrations with Halo can import and create Users with information from the integration platform. Each integration differs slightly in approach, so check out the relevant guide for your integration to do so.</p><p><br></p><p>Most integrations will work on the same premise: a matching Field to determine if a new User is created or an existing one updated, and mappings to determine which Site they are added to.</p><p><br></p><p>There will be a button to "Import Users" (similar to the CSV import). This will bring up the same import screen with a list of Users in that program, and the import can be started manually there. There is also the option to automate these imports through the "Halo Integrator". If enabled, Halo will automatically run imports once a day to import or update details on these Users. If you are hosted, this sync will be handled automatically by us.</p><p><br></p><p><strong><em>Note: Manually importing Users for the first time creation is a good way to ensure that the import works smoothly before configuring the automatic sync. </em></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJiMDg0YmI4LThmMGMtNDc4ZS04NTYzLWRkNDY3MDU3MTI1ZSJ9.5nAL-wJO7Qv5GRpGFpHDV257SeBrogU9qJe2ZA7xs44" class="fr-fic fr-fil fr-dib" width="1222" style="width: 1224px; height: 324.046px;" height="324"></p><p><strong><span style="font-size: 10pt;">Fig 26. Example Okta User/Agent import.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Sending Welcome and Password Emails</span></strong></p><p>Upon creation of a user, the following buttons will be available.</p><p><br></p><ul><li><strong>Send Welcome Email: </strong>Sends an email template with the URL of your Self-Service Portal, and the user's login credentials for it.</li><li><strong>Send Password Reset Email:</strong> Sends an email template with a link for the user to change their password.</li></ul><p><br></p><p data-pasted="true"><strong><em>Note: These will not show if the "Web Access Level" is set to "No Access" on the user, as this means they will not be granted the ability to log into the portal.</em></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3Zjc3YWM2LTMwZjctNDI2Yi1iZTY4LWI2Nzk4YmI1Nzk5MCJ9.CljxjpbTi8HI5dy102Sg0WNfKTGhtCvlYq-S-7Z1gKk" class="fr-fic fr-fil fr-dib" width="502" height="178"></p><p><strong><span style="font-size: 10pt;">Fig 27. Email buttons on a user.</span></strong></p><p><br></p><p>The email templates for both can be found with the IDs 80 and 186, and will contain dollar variables to populate the information upon sending. If customising or branding these templates, ensure the variables are present somewhere still.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImRkMWI4NjY0LWNkNTUtNGE0Ny05NjJiLWQ5MTUxODE5ZTE4YiJ9.oxL0ttBS1IPvVRjNWLcdFpe7cxnhU6r7vjI9jErnR-E" class="fr-fic fr-fil fr-dib" width="716" style="width: 718px; height: 540.543px;" height="541"></p><p><strong><span style="font-size: 10pt;">Fig 28. Welcome email template.</span></strong></p><p><br></p><p>Welcome emails can also be automated to send when a user is created, which includes those made by imports or integrations. In Configuration > Email > General Settings, there will be an option to send these. Additionally, there is the option to configure how long these credentials last for before they expire. This defaults to one day.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZiMjA2ODg4LTIxNGUtNDA4OC1hY2Y5LWM4YjZmZjJlNjc4NCJ9.gDqebCs59vtiKC93h7rv9fQtfu3dnrPNGC6I4gp43QI" class="fr-fic fr-fil fr-dib" width="308" height="120"></p><p><strong><span style="font-size: 10pt;">Fig 29. Welcome email options.</span></strong></p><p><br></p>
