<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><span style="font-size: 11pt;">In this guide we will cover:</span></strong></p><p><span style="font-size: 11pt;"><strong>- How are Tickets Created via Email?</strong></span></p><p><strong><span style="font-size: 11pt;">- How are Tickets updated via Email?</span></strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">How are Tickets Created via Email?</span></strong></p><p>Tickets are logged via email when an email is sent into a mailbox that is connected to your Halo. </p><p><br></p><p>If an email is received into a mailbox, and this email cannot be matched to an existing ticket, a new ticket will be logged. Once the email has been processed (and a ticket is logged) this email will be removed from your mailbox. </p><p><br></p><p>Keep in mind we do have some global, and mailbox level setting that prevent new tickets being logged via email. Checkout <a data-fr-linked="true" href="https://usehalo.com/haloitsm/guides/2433" id="isPasted" target="_blank" rel="noopener noreferrer">Disallowing New Tickets via Email</a> for more information on this. </p><p><br></p><p><strong><span style="font-size: 12pt;">What Type of Ticket is Logged?</span></strong></p><p>The type of ticket (ticket type) that is logged from the email will be determined by the mailbox the email was sent into. </p><p><br></p><p>To see what ticket type will be logged for emails sent to a mailbox head to Configuration > Email > Mailbox > select a mailbox > Incoming tab, see "Ticket Type for New Tickets created from this Mailbox".</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjlhZGJiMWZiLTg5MmQtNGNlMy05YmMzLTJiZDJkYzAwNjNjYyJ9.J4MGFWRODbbcHojmpe-xdCaxu6PF5LpjeFa-31zAKXU" class="fr-fic fr-fil fr-dib" width="543" style="width: 545px; height: 315.008px;" height="315"></p><p><strong><span style="font-size: 10pt;">Fig 1. Ticket Type for New Tickets created from this Mailbox </span></strong></p><p><br></p><p>The ticket type set here will be the ticket type that is logged for all emails sent to this mailbox. This can be changed using the dropdown. If you would like a different ticket type logged in certain circumstances you can setup an <a data-fr-linked="true" href="https://usehalo.com/haloitsm/guides/1910" id="isPasted" target="_blank" rel="noopener noreferrer">email rule</a> to change this. </p><p><br></p><p><strong><span style="font-size: 12pt;">Which User is the Ticket Assigned to?</span></strong></p><p>The end user of the ticket will be determined by the email address the email was sent from. All users in your Halo will be checked until a user with this email address is found, this user will be assigned the ticket. If no users have this email address the setting "If the email sender cannot be matched to a Use" against the mailbox will control who the ticket is assigned to. </p><p><strong><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdiNTI3Yzg5LWU5MzYtNDhmNi04M2ZiLTIzYjVkODIyMjk3MSJ9.uifC29Minkk3o8buqBHhsAXRgJJ-RJswg87PdwoUeC8" class="fr-fic fr-fil fr-dib" width="1001" style="width: 1003px; height: 490.811px;" height="491"></strong></p><p><strong><span style="font-size: 10pt;">Fig 2. Setting to determine who the ticket will be assigned to if a user cannot be matched</span></strong></p><p><strong><br></strong></p><p><strong><span style="font-size: 12pt;">How can I Tell if a Ticket was Logged via Email? </span></strong></p><p>Tickets logged via email will have the first action labelled as 'First User Email' as shown in figure 3.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRmZGIyYWNlLWI5NDgtNDM5OS1hZTNkLTNhZTBhODYwMzAyYiJ9.cMeONKHzfVDaNxAYyCNF1ol6pFWhHRpiJRzBjFkingc" class="fr-fic fr-fil fr-dib" width="1228" style="width: 1230px; height: 483.142px;" height="483"></p><p><strong><span style="font-size: 10pt;">Fig 3. Ticket logged via email</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">How are Tickets Updated via Email?</span></strong></p><p>Users, and agents can update existing tickets via email. This is done by sending an email to one of the mailboxes you have connected to your Halo instance. However, the email must match to an existing ticket in order to update it. </p><p><br></p><p><strong><span style="font-size: 12pt;">Matching an Email to a Ticket</span></strong></p><p>Emails are matched to tickets using the ticket ID. This ticket ID must be present in the subject of the email and must be contained within 'Tags'. </p><p><br></p><p><strong>What are tags? -</strong> A sting of characters surrounding a ticket ID. When Halo processes an email these tags are searched for, the value between these tags is assumed to be the ticket ID. If a ticket with this ID exists the email will update the matched ticket. Otherwise a new ticket will be logged. </p><p><br></p><p>Tags are used to prevent emails matching to tickets when the email contains other numerical values that happen to be the same as a ticket ID in your instance. </p><p><br></p><p>In the figure 4 example, the email will be matched to, and update ticket 0002999.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg3YTIyZjRiLTdiNzUtNDllNC1iMTI1LTI0NmQ3ZWRhYTFiNSJ9.E6paHwWyGTR8dtmM1jyNz0_pCh-CocPMRPNg6ntx0I0" class="fr-fic fr-fil fr-dib" width="876" style="width: 878px; height: 556.895px;" height="557"></p><p><strong><span style="font-size: 10pt;">Fig 4. Email to update existing ticket</span></strong></p><p><br></p><p>This is because it contains the ticket ID 0002999 in the email subject and this ID is between the email tags. In this example "[IN:" is the start tag and "]" is the end tag. </p><p><br></p><p>When agents send emails out from Halo the matching ID will be included in the email subject by default. Therefore, when users reply to this email, their reply will contain the matching ID in the subject automatically. </p><p><br></p><p>Additional tags can be set at the following levels to allow for more customised matching:</p><ul><li>Global</li><li>Ticket Types</li><li>Sites</li></ul><p><strong><em>Note: Custom ticket ID tags should be unambiguous, there shouldn't be any way that the sequence can be used accidentally i.e '!' and '?' would be inadequate for start and end tags.</em></strong></p><p><br></p><p><strong>Global Email Tags</strong></p><p>To set the default global tags head to Configuration > Email > General Settings, here you will see the fields "Email Start Tag" and "Email End Tag". Here, enter the values you would like the ticket ID to appear between. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM5M2IxY2JhLTNhNzktNDliNC1hN2U0LTg1MWNlZTBhOTgxZSJ9.OSbkU41Myuf0kL0EZpl29UPbTOLf1HR4MyAcSr3oTrY" class="fr-fic fr-fil fr-dib" width="1173" style="width: 1175px; height: 284.3px;" height="284"></p><p><strong><span style="font-size: 10pt;">Fig 5. Email start and end tag, global setting</span></strong></p><p><br></p><p>This is useful if you would like the tags to more accurately reflect your branding or organisation. </p><p><br></p><p>The drop-down "Additional Email matching method" can set the property to match on if the tag cannot be matched.</p><p> </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc2ZTNiNjc1LTMxMzItNGMzOS1iZjY5LWFmYTY1MmQ5MGU3NiJ9.xfYUfHOsuQnBjXoXLjAL_q1DKwr-m7aJjkNRIasvsRg" class="fr-fic fr-fil fr-dib" width="649" height="535"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 6. Additional Email matching method</span></strong></p><p><br></p><p><strong>Ticket Type Email Tags</strong></p><p>Email Tags can be set per ticket type, to override the global default tags. Useful if you would like to customise tags per ticket type for visibility purposes.</p><p><br></p><p>To set email tags per ticket type head to Configuration > Tickets > Ticket Types > select a ticket type > Settings tab > Email section, here you will see the fields "Email Start Tag" and "Email End Tag".</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZlZTRlZWU5LTcwNzktNDllYi05NTMxLTU1MTU2Y2YzYTFlZCJ9.VuCqIcGpBvwAtMEd6tDxSflN5_tIWdT1NdMS4siCC3Y" class="fr-fic fr-fil fr-dib" width="985" style="width: 987px; height: 289.955px;" height="290"></p><p><strong><span style="font-size: 10pt;">Fig 7. Email tag override against ticket type</span></strong></p><p><br></p><p>If these fields are set this will override the global default tags for tickets of this type. This means all ticket IDs for tickets of this type will be contained within the tags set here. Users will need to send an email in with these ticket type specific tags in order to update the ticket. </p><p><br></p><p>Outgoing emails for this ticket type will also have the ticket ID contained within these tags.</p><p><br></p><p>In the figure 8 example tags have been set such that all Incident ticket types will have their ID contained within the tags "[Incident: xxx]".</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImEyZGE0NjhmLTVlMjMtNDE2YS1hMDA4LTBmMDFiMGRhNDBiMyJ9.MzwhLzNfy5Wk0QoQyOmMoHGv31Xttvn9aXTmzoUtavA" class="fr-fic fr-fil fr-dib" width="1026" height="297"></p><p><strong><span style="font-size: 10pt;">Fig 8. Example email tag override against ticket type</span></strong></p><p><br></p><p><strong>Site Email Tags</strong></p><p>You can set email tags for each of your sites too. This allows emails to be matched to tickets using the ticket ID either between the ticket type/global tags or the ticket ID between the tags set for that site. </p><p><br></p><p>This is used when particular sites (locations) strip the tags from the email subject and replace it with their own. </p><p><br></p><p>To set site level tags head to Customers/Organisations > Sites > select a site > Settings tab, here you will see the fields "Email start tag for third party ID" and "Email end tag for third party ID".</p><p><br></p><p>The values set in these fields control what values the ticket ID will be presumed to be stored between. For every email from a user under this site, the system will check the value between these tags for a ticket ID. If this matched an existing ticket, this ticket will be updated. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImVhYzk2Y2VjLTFmYzUtNGI5Ny05OGMyLTczYjQ5MmZmOTQ5OCJ9.oQ9i6evJGBSZdvmHmlzOfUBa90vcCDdWO56jHe8DTyw" class="fr-fic fr-fil fr-dib" width="861" style="width: 863px; height: 324.775px;" height="325"></p><p><strong><span style="font-size: 10pt;">Fig 9. Email tags per site</span></strong></p><p><br></p><p>In the figure 9 example, users under the Melbourne site can send an email with the ticket ID contained within the tags "[Melbourne: XX]" in order to update the ticket. </p><p><br></p><p>Users will still be able to update tickets using the ID contained within the default tags, this just provides an additional option for matching in case certain sites have their own identifier tags. </p><p><br></p><p><strong>Supplier Email Tags</strong></p><p>Supplier email tags can also be configured to allow emails from suppliers to be matched to tickets using the unique supplier reference (rather than the ticket ID). The supplier tags determine where this supplier reference is checked for in the email. </p><p><br></p><p>For more information on this checkout our guide on <a data-fr-linked="true" href="https://usehalo.com/haloitsm/guides/2101" target="_blank" rel="noopener noreferrer">Suppliers.</a> </p><p><br></p><p><strong><span style="font-size: 12pt;">Status Change after email updates</span></strong></p><p>The status of a ticket can change after an end user updates a ticket, both when they update the ticket via email or from the portal. </p><p><br></p><p>The status the ticket will move to after an update is set against the ticket type. Under Configuration > Tickets > Ticket Types > select a Ticket Type > Settings tab, you can set the "Status after End-User update".</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjMwZGE0YTBmLTMwNTUtNGQ0MS04NTgxLTBhYzhmNjA1M2E1ZiJ9.n0fxmfTc1X746op4YURdqF8rPHULBcmluSGlkIISplo" class="fr-fic fr-fil fr-dib" width="589" style="width: 591px; height: 312.827px;" height="313"></p><p><strong><span style="font-size: 10pt;">Fig 10. Status after end user update</span></strong></p><p><br></p><p>In the figure 11 example, tickets with the type "Incident" are set to move to the 'Updated' status when an end user updates the ticket. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjlhOTY2NjEyLWQxYWEtNDU4Ny1hODg2LTg4MzYxZTU2YWU3NiJ9.3FmShLxoWmTTNsqfTAQvZAYz4UQlxcTkfXvyYynW6lk" class="fr-fic fr-fil fr-dib" width="1138" style="width: 1140px; height: 578.63px;" height="579"></p><p><strong><span style="font-size: 10pt;">Fig 11. End user update changing the status of the ticket </span></strong></p><p><br></p><p>Status changes are important as they control if the ticket is taken off SLA hold when a user update is received. Out of the Box, the "Updated" status will take the ticket off SLA hold, but this can be customised using <a data-fr-linked="true" href="https://usehalo.com/haloitsm/guides/1929" id="isPasted" target="_blank" rel="noopener noreferrer">status settings</a>. </p><p><br></p><p><strong><span style="font-size: 12pt;">Emails on Closed Tickets</span></strong></p><p>You can customise how emails that match to a closed ticket are treated for each ticket type. </p><p><br></p><p>To set this head to Configuration > Tickets > Ticket Types > select a ticket type > Settings > Closure settings section and toggle "User Emails on closed Ticket". </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU4MzY1MGI5LTViNDQtNDc3Ni1hMzM5LTBhODVhMmI2ZDU4OSJ9.Vu-U2r8YJy75ziCgB6kaMDVMBbqgMVqTUGn7ICtQOco" class="fr-fic fr-fil fr-dib" width="806" height="512"></p><p><strong><span style="font-size: 10pt;">Fig 12. Setting to control how emails on closed tickets are treated</span></strong></p><p><br></p><p><br></p><p><br></p><p><br></p>
