<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><div><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 is the ServiceNow Integration?</strong></span></p><p><span style="font-size: 11pt;"><strong>- Connecting to ServiceNow</strong></span></p><p><span style="font-size: 11pt;"><strong>- Creating tickets in ServiceNow</strong></span></p><p id="isPasted"><span style="font-size: 11pt;"><strong>- Updating Records in ServiceNow through Halo</strong></span></p><p><strong><span style="font-size: 11pt;">- Syncing back to Halo</span></strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the ServiceNow Integration?<br></span></strong></p><p id="isPasted"><span style="font-size: 11pt;">The ServiceNow integration allows you to connect a ServiceNow account to each of your Customers and Suppliers. This creates a two way sync between Halo and ServiceNow. Tickets raised in Halo can be synced to ServiceNow as Incidents or Tasks. Incidents/Tasks raised in ServiceNow can be synced to Halo as tickets. Updates can also be synced, with a two way sync of work notes supported. The following ticket fields can be synced from ServiceNow to Halo:</span></p><p><br></p><ul><li data-pasted="true" style="font-size: 11pt;">Status</li><li style="font-size: 11pt;">Category</li><li style="font-size: 11pt;">Priority</li><li style="font-size: 11pt;">Impact</li><li style="font-size: 11pt;">Urgency</li><li style="font-size: 11pt;">Assignment Group</li><li style="font-size: 11pt;">Custom Field</li><li style="font-size: 11pt;">Services</li></ul><p><br></p><p><span style="font-size: 11pt;">A combination on webhooks and the Halo integrator are used to support the sync, each supporting different elements.</span></p><p><br></p><p><strong><span style="font-size: 14pt;">Connecting to ServiceNow</span></strong></p><p><span style="font-size: 11pt;">Start by heading to Configuration > Integrations > ServiceNow and enabled the integration module using the '+' icon. </span></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE3NTQ5YzNkLTdmOTEtNDU4My05MWZkLWEwZjJkOGJkZWFmZSJ9.1DwtEZjV2AuNeEt0Se_vhEN8LQEODFEW2npccuwngFI" class="fr-fic fr-fil fr-dib" width="212" height="151"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enable integration module </span></strong></p><p><br></p><p><span style="font-size: 11pt;">The integration module is used to enable the Halo integrator and attachment syncing for the integration but the credentials and integration configuration are configured per Customer and Supplier.</span></p><p><br></p><p><span style="font-size: 11pt;">Once the integration is enabled, a ServiceNow tab will appear on the Customer and Supplier details page. Here you can enter the credentials for their instance of ServiceNow. These credentials must be validated before setting up any of the mappings.</span></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImZiOTAzOTQzLThlNDMtNDFhZC05NjdhLTZmYTkzMmMxODJmYiJ9.ZGUkie-x6eamTwGDHkQdDtqARLN1WY4OzFY71lv__AY" class="fr-fic fr-fil fr-dib" width="1099" style="width: 1101px; height: 471.054px;" height="471"></p><p><strong><span style="font-size: 10pt;">Fig 2. Credentials to connect to ServiceNow</span></strong></p><p><br></p><p><span style="font-size: 11pt;">When authenticating the connection you can choose between one of two connection types, basic authentication or client credentials. </span></p><p><br></p><p><strong><span style="font-size: 11pt;">Basic authentication</span></strong><span style="font-size: 11pt;">- When this authentication type is selected you will need to enter log in credentials for this Customer's ServiceNow. The account logged in with must have permission to access/modify each area of ServiceNow you would like Halo to be able to update/modify. </span></p><p><br></p><p><span style="font-size: 11pt;"><em><strong>Note: The user providing the credentials must have the email address used for their account in ServiceNow match a user account in Halo.</strong></em></span></p><p><br></p><p><span style="font-size: 11pt;"><strong>Client Credentials (OAuth 2.0)</strong> - When this authentication type is selected you will not need to use a specific user's credentials to log in, instead you can generate client credentials (ID and secret) to authorise the application. For information on how to obtain these credentials see this helpful article on ServiceNow's community page: <a data-fr-linked="true" href="https://www.servicenow.com/community/developer-blog/up-your-oauth2-0-game-inbound-client-credentials-with-washington/ba-p/2816891">https://www.servicenow.com/community/developer-blog/up-your-oauth2-0-game-inbound-client-credentials-with-washington/ba-p/2816891</a>. If you are using this method a minimum of 1800 seconds should be set for the Access Token Lifespan.</span></p><p><br></p><p><span style="font-size: 11pt;">Once you have entered your credentials use the 'Validate Credentials' button. You will need to enter credentials and mappings for each Customer and Supplier using ServiceNow. This allows you to configure different mappings per Customer/Supplier. </span></p><p><br></p><p><span style="font-size: 11pt;">Once validated, some additional configuration options will appear. </span></p><p><br></p><p><span style="font-size: 12pt;"><strong>Field Mappings</strong></span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjBmOWI3NGQ5LTI2NWMtNDVlNi05ZDllLWM0ZmVhMzcwM2Q0YSJ9.kU5tyItzTsXXQVXUgjzlOsupU4jD4IeGAzV15-i8bcM" class="fr-fic fr-fil fr-dib" width="1247" style="width: 1249px; height: 441.398px;" height="441"></span><br></p><p><strong>Fig 3. Field mappings</strong></p><p><br></p><p><span style="font-size: 11pt;">The field 'ServiceNow Integrator Import Entities' will determine which entities are imported from ServiceNow, Incidents, Tasks, Problems, change requests and service requests. These use the existing incident mappings.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">Below this you can configure status mappings for Halo fields and ServiceNow states. These mappings will determine what status a ticket will have when created in Halo from ServiceNow. When adding a mapping you can choose whether the mapping applies to both Incidents and Tasks, or you can configure separate mappings for Tasks and Incidents. Tickets created in ServiceNow by Halo (outbound) will have the state '<strong>New</strong>' in ServiceNow. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">You can then add category mappings to determine what category a ticket will have when created in ServiceNow. These mappings will only apply to Incidents created in ServiceNow, Tasks will not have a category when created. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">You can then add priority, impact, urgency, assignment group and custom field mappings to determine what priority, impact, urgency, assignment group and custom fields a ticket will have when created in ServiceNow. When adding a mapping you can choose whether the mapping applies to both Incidents and Tasks, or you can configure separate mappings for Tasks and Incidents by setting the 'ServiceNow Type' the mapping applies to. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;"><strong><em>Note: When mapping single select custom fields you will need to map the field values (options to choose from) values in ServiceNow field. This will determine what data appears in the ServiceNow field.</em></strong></span></p><p><br></p><p><span style="font-size: 11pt;"><span style="font-size: 11pt;" id="isPasted">Service requests require mapping specific services in Halo to ServiceNow via the below table. After saving, you can then add custom field mappings to each service mapping.</span></span></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjIyMzI3OTI3LTdkN2ItNDE2NC1hN2JmLWRjYzc5ZWM2ODE2NSJ9.Cfi240dELYmVlAqCLiQDiM-BSRopXkSoDXXeU0DAlDM" class="fr-fic fr-fil fr-dib" width="1115" style="width: 1117px; height: 132.685px;" height="133"></p><p><span style="font-size: 10pt;"><strong>Fig 4. Service mappings.</strong></span></p><p><br></p><p><span style="font-size: 11pt;">Once you have configured you mappings you can set a 'Default Assignment Group', this will determine what assignment group the Incident/Task will be assigned to in ServiceNow if the team assigned to the Halo ticket cannot be matched to a mapping. </span></p><p><br></p><p id="isPasted"><span style="font-size: 11pt;">You will also need to set a 'Default caller', this determines the caller (user) that will be assigned to the Incident/Task in ServiceNow if the user in Halo cannot be matched to a user in ServiceNow (users will match on email address). </span></p><p><span style="font-size: 11pt;"><br></span></p><ul><li><span style="font-size: 11pt;"><strong>Sync attachments to ServiceNow</strong> - This field will determine if attachments are synced to ServiceNow for this Customer. This is enabled globally but can be overridden per Customer using this setting. </span></li><li><span style="font-size: 11pt;"><strong>Sync child Tickets when sending problems to ServiceNow</strong> - Allows child incidents to be synced when syncing their parent problem.</span></li></ul><p data-pasted="true"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjA0YWVkNTE3LTlhOTItNDQ0ZC1iM2IzLTI4Mzg2ZTk1MGQ1YyJ9.MkuYd2uEuqogk-EaLFGIGxKKXWX62NA0AeIp3VdGg54" width="1124" style="width: 1126px; height: 278.733px;" height="279" class="fr-fic fr-dii"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 5. Additional ServiceNow settings against Customer</span></strong></p><p><br></p><p><span style="font-size: 11pt;">As of v2.232.1+, the following additional mapping options can be used: </span></p><p><br></p><p><span style="font-size: 11pt;">ServiceNow tables can be mapped to Halo Ticket Types using the Ticket Types mapping table.</span></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY0NDc4ODVmLTIyZDItNDMyZS04MWMyLWY1NWNhY2NkN2ZkZCJ9.kcwNIM64OEfpabBCDAwDd_38717fh_HBgs9cFyfpZek" class="fr-fic fr-fil fr-dib" width="1214" height="201"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 6. Ticket Type mappigns </span></strong></p><p><br></p><p><span style="font-size: 11pt;">Halo categories can be mapped to ServiceNow categories and subcategory fields. These can target specific ServiceNow tables by setting them as the ServiceNow Type. </span></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQxYmQxYTEwLTM5ZjUtNDAzNC1hMmRmLTdkYjZjMzUxYzY2MiJ9.pfTIzVnSBbgDiX_bJObbFXwF1Lt-n1tpiOsER366fQA" class="fr-fic fr-fil fr-dib" width="1201" style="width: 1203px; height: 198.037px;" height="198"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 7. Category mappings </span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Webhooks</span></strong></p><p><span style="font-size: 11pt;">Webhooks can be enabled per Customer and Supplier. These allow:</span></p><p><br></p><ul><li><span style="font-size: 11pt;">New tickets in ServiceNow to create tickets in Halo automatically.</span></li><li><span style="font-size: 11pt;">Work notes/additional comments added in ServiceNow to sync to the ticket in Halo <span style="font-size: 11pt;" data-pasted="true">automatically. </span></span></li><li><span style="font-size: 11pt;">Updates from suppliers to update existing tickets in Halo. </span></li></ul><p><span style="font-size: 11pt;"><em><strong>Note: Supplier webhooks can only be used to update existing tickets, not create new tickets.</strong></em></span></p><p><br></p><p data-pasted="true"><span style="font-size: 11pt;">First you will need to set the ticket type new tickets from ServiceNow will create as well as the user these ticket will be assigned to. Then you will need to configure the webhooks in the ServiceNow instance to send to Halo.</span></p><p><br></p><p><span style="font-size: 11pt;">The webhook to create tickets in Halo will create the ticket and populate any mapped fields using data from ServiceNow. The webhook to update tickets in Halo will sync work notes and additional comments added in ServiceNow to Halo, only the work note is synced, additional field updates will not be pushed across. Field updates are handled by the Halo Integrator (see the section "Syncing back to Halo" for more information on the Halo Integrator).</span></p><p><br></p><p><span style="font-size: 11pt;">From v2.232.1+, you can also specify the Team to assign Tickets to using the "Webhook Team" dropdown. </span></p><p><br></p><p><span style="font-size: 11pt;"><em><strong><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImVkNGZkMjkyLTZlMDUtNDBmOS1hNjk2LWVhMjE3OTJmZWRkOSJ9.yTj130YQZZIgE7HGbWfqm-xow9cG3qjccQTso097cps" class="fr-fic fr-fil fr-dib" width="922" style="width: 924px; height: 600.907px;" height="601"></strong></em></span><strong>Fig 8. Webhook processing configuration</strong></p><p><br></p><p><span style="font-size: 11pt;">For information on setting up the webhooks required see our article <a data-fr-linked="true" href="https://usehalo.com/haloitsm/guides/1757/" target="_blank" rel="noopener noreferrer">ServiceNow Webhooks</a>. </span></p><p><br></p><p><strong><span style="font-size: 14pt;">Syncing Incidents to ServiceNow</span></strong></p><p><span style="font-size: 11pt;">To sync incident and task tickets from Halo to ServiceNow, you will need to create an action with the system use 'Send ticket to ServiceNow'. This will create the current ticket in the the customer's ServiceNow instance, any of the fields mapped earlier will be set. The Customer this will be assigned to is determined by the Customer/User of the ticket so ensure the ticket is assigned to the correct Customer before syncing.</span></p><p><br></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE3NzMwZmYzLTgwZmUtNDY1Yi1iMmQwLTA0OGExYjI2ZDk0NiJ9.LUsvareRfnILtjwBgABCTCCcNyLnr9bXLqhBKr66yes" class="fr-fic fr-fil fr-dib" width="976" style="width: 978px; height: 343.203px;" height="343"></span><strong>Fig 9. Action to send a ticket from Halo to ServiceNow</strong></p><p><br></p><p><span style="font-size: 11pt;">There are two ways you can determine what what type of ServiceNow record this ticket will be created as, this can be set against the ticket type, so this Halo ticket type will always be created as the chosen record. Or this can be done using an action, so you can choose per sync what record type the ticket is created as. </span></p><p><br></p><ul><li style="font-size: 11pt;"><strong>Setting a ServiceNow record type against a ticket type</strong></li></ul><p style="margin-left: 20px;"><span style="font-size: 11pt;">To set the ServiceNow record against the ticket type head to Configuration > Tickets > Ticket Types, select a ticket type, and head to the Defaults tab. Here you can set the "Default ServiceNow Type".</span></p><p style="margin-left: 20px;"><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjBhMzc3OWQ4LTgxOTktNGQ0NS1iNzBlLTg0ZGU4MjZlYzRmYiJ9.dCuIlDL-0hnbNMyamibBDOFSPSqhJtgVEC6AeWJBG5E" class="fr-fic fr-fil fr-dib" width="1011" style="width: 1013px; height: 592.734px;" height="593"></span><strong>Fig 10. Set the type of record) this ticket type will be created as in ServiceNow</strong><span style="font-size: 11pt;"><br></span></p><p><br></p><p style="margin-left: 20px;"><span style="font-size: 11pt;">Now when any tickets of this type are sent to ServiceNow they will be created as this type. </span></p><p style="margin-left: 20px;"><br></p><p><span style="font-size: 11pt;"><br></span></p><ul><li style="font-size: 11pt;"><strong>Setting a ServiceNow record type against an action</strong></li></ul><p style="margin-left: 20px;"><span style="font-size: 11pt;">To use an action to set the ServiceNow record head to Configuration > Tickets > Actions, select the action used to send the ticket to ServiceNow and click the Field List tab, here add 'ServiceNow Type' to the field list.</span></p><p><br></p><p style="margin-left: 20px;"><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNjNTQ1ZjdmLWRmYmMtNDZjZi05NGY1LTM3NDBkYzQ2ZjY3MyJ9.DkGNkm8oum3_FlQu7HcFw3KKXungvfDgtRsfQfHXoEQ" class="fr-fic fr-fil fr-dib" width="1357" style="width: 1359px; height: 389.047px;" height="389"></span><br></p><p style="margin-left: 20px;"><strong>Fig 11. ServiceNow Record field</strong></p><p><br></p><p style="margin-left: 20px;"><span style="font-size: 11pt;">Each time this action is used the agent can choose what ServiceNow type the ticket will be created as. If a default ServiceNow type is set against the ticket type this can be overridden using an action</span></p><p><br></p><p><br></p><p><span style="font-size: 11pt;">Tickets in Halo and incidents/tasks in ServiceNow have a 1-1 relationship, this means only one ticket in Halo can be linked to one incident in ServiceNow at a time, you cannot link multiple tickets to a single ServiceNow incident. If the action 'Send ticket to ServiceNow' is used again to link to a different incident, the existing link will be overwritten.</span></p><p><br></p><p><span style="font-size: 11pt;">However, parent and child relationships will remain when syncing tickets to ServiceNow. If a ticket is synced to ServiceNow as a Task and it's Parent Ticket in Halo is synced as an incident in ServiceNow, the Task will be linked to the Incident in ServiceNow, mirroring their relationship in Halo. </span></p><p><br></p><p><span style="font-size: 11pt;">The User of the incident will try to match on the End User's email of the ticket in Halo. If the End User's email (of the ticket in Halo) can be matched to a User in ServiceNow, the matched User will be assigned the incident in ServiceNow. Otherwise the default User set against the Customer (in Halo) will be assigned the incident. </span></p><p><br></p><p data-pasted="true"><span style="font-size: 11pt;">From v2.236+, you can view if the outbound request has been successful in the Outbound Integration Request log in <a href="https://usehalo.com/haloitsm/guides/2435" target="_blank" rel="noopener noreferrer" style="font-size: 11pt;">Backend Service Monitoring</a>. </span></p><p><br></p><p id="isPasted"><strong><span style="font-size: 12pt;">Syncing Supplier Records to ServiceNow from Halo</span></strong></p><p><span style="font-size: 11pt;">If you have connected your Suppliers' instance of ServiceNow an action with the system use 'Log to Supplier' can be used to create the ticket in the Supplier's ServiceNow instance. In order to use this action the Supplier must have an email address set against them. </span></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjgxZTRjNjFkLTcyZmItNDcyOC1iOTg4LTUxZTJmNGFhMDIzOCJ9.mYdF9Eh1V3zGZRexiiu47QDjiqbzGsKUvcYhI8uhvZM" class="fr-fic fr-fil fr-dib" width="1186" style="width: 1188px; height: 282.004px;" height="282"></p><p><strong>Fig 12. Action with Log to Supplier System use</strong></p><p><br></p><p><span style="font-size: 11pt;">Actions with this system use will only create a record in ServiceNow if the supplier you are logging to has a ServiceNow instance connected to their Supplier profile in Halo. This allows you to use the same action for logging issues to suppliers for both suppliers using ServiceNow and those who are not. </span></p><p><br></p><p><strong><span style="font-size: 12pt;">Syncing Attachments </span></strong></p><p><span style="font-size: 11pt;">Attachments can be sent from Halo to ServiceNow, allowing any public attachments that have been added to the ticket in Halo to be created against the linked record in ServiceNow. This is a one way sync (Halo to ServiceNow). </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">To allow the syncing of attachments head to configuration > integrations > ServiceNow, enable 'Sync attachments to ServiceNow'. </span></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImUyZDUwNDBmLWYwZjMtNGE2Yi1hM2U1LTExMjM1ZDJhMzQxYiJ9.IlM13gctKBSZbCVV39WBT7qdMQq0TK462_xZ1_hPgak" class="fr-fic fr-fil fr-dib" width="999" style="width: 1001px; height: 426.493px;" height="426"></p><p><strong>Fig 13. Sync attachments to ServiceNow</strong></p><p><br></p><p><span style="font-size: 11pt;">This can be overridden per Customer and Supplier using the same setting present against the Customer/Supplier ServiceNow configuration. This allows you to only sync attachments for chosen Customers/Suppliers. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">Attachments will be sent to ServiceNow when the ticket is created in ServiceNow, or when an action is used to update the ServiceNow record. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><strong><em><span style="font-size: 11pt;">Note: Only attachments that are publicly visible will sync to ServiceNow.</span> </em></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Updating Records in ServiceNow through Halo</span></strong></p><p><span style="font-size: 11pt;">Actions added to tickets in Halo can add work notes to the linked ServiceNow Incident/Task. To send a work note you will need to create an action with the "Sync to ServiceNow" field. The note on the action will sync to ServiceNow as a work note as long as this field is checked. </span></p><p><br></p><p><span style="font-size: 11pt;">Only the 'Note' field can be synced to ServiceNow from Halo. Any of the earlier mapped fields (priority, impact, custom fields, etc) will not be updated. If additional fields are present on the action this will not affect the sync but the data from these fields will not be synced across. </span></p><p><br></p><p><span style="font-size: 11pt;"><strong><em>Note: This field does not apply to a Supplier sync, see the next section for more information on how to configure an action to update a Supplier.</em></strong></span></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg5OWUwZTgwLWFkMWQtNGFjZC1hYWNkLWE2N2IzZDhiNTEwNiJ9.zRVVq6B5sWQ9Wrrc57N11SN9JdhPvcK5lr1jwzp1Lic" class="fr-fic fr-fil fr-dib" width="1305" style="width: 1307px; height: 416.441px;" height="416"></p><p data-pasted="true"><strong>Fig 14. Fields against action to sync the action to ServiceNow</strong></p><p><br></p><p><span style="font-size: 11pt;">If you would like this checkbox to be selected by default when you use your action you can select the "Sync to ServiceNow" option in the defaults tab.</span></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRjZDFmOGY3LWQ2NTQtNDVlNS1iMzUzLWYyZGJhMmYxNzFlNyJ9.ymQW22U4TuolI0nobTP3RMoLwzh-hgP3KeX8fBLM36w" class="fr-fic fr-fil fr-dib" width="547" height="454"></p><p data-pasted="true"><strong>Fig 15. Sync the action to ServiceNow by default </strong></p><p><br></p><p><span style="font-size: 11pt;">If the action is set to be hidden from the User it will be a Work Note in ServiceNow, otherwise, it will be a Comment.</span></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjAxNTI3NWViLWNhYTEtNDczYy1hMmNhLTE5NTZiMDY5Njc1MSJ9.Ak9tNjIwslzmGTiV7DbumiBLjk9YdOru_bqIRasAHTc" class="fr-fic fr-fil fr-dib" width="1300" style="width: 1302px; height: 591.353px;" height="591"></p><p><strong>Fig 16. Setting to hide action from the user (private action)</strong></p><p><br></p><p><span style="font-size: 11pt;">Only actions that have the "Sync to ServiceNow" field checked will send updates to the linked incident in ServiceNow for a Client sync. If you would like all internal and/or public notes to sync to service now you will need to add this field to each of your actions that you use for leaving public/private notes on a ticket. </span></p><p><br></p><p><span style="font-size: 12pt;"><strong>Sending updates to Suppliers</strong></span><strong><span style="font-size: 12pt;"><br></span></strong></p><p data-pasted="true"><span style="font-size: 11pt;">If you are sending an update to a Supplier ticket you will not need the "Sync to ServiceNow" checkbox to be set on the action. This action will instead need the the system use "Email Supplier". Providing the Supplier has an email address set against their record this action will send the update across to ServiceNow.</span></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJhNzQ3MGFmLTE2MjQtNDI4MC05MWViLTAzNTk4NjU1MThkZCJ9.iU0pVZmNQEz84RUVS9VyL26hHn59IKzkRwMk4f0Bego" class="fr-fic fr-fil fr-dib" width="1260" style="width: 1262px; height: 224.706px;" height="225"></p><p data-pasted="true"><strong>Fig 17. Email Supplier System Use</strong></p><p><br></p><p data-pasted="true"><span style="font-size: 11pt;">From v2.236+, you can view if the outbound request has been successful in the Outbound Integration Request log in <a href="https://usehalo.com/haloitsm/guides/2435" target="_blank" rel="noopener noreferrer" style="font-size: 11pt;">Backend Service Monitoring</a>. </span></p><p><br></p><p><strong><span style="font-size: 14pt;">Syncing back to Halo</span></strong></p><p><span style="font-size: 11pt;">Webhooks are used to sync new tickets and work notes/additional comments from ServiceNow to Halo. If you have webhooks configured each time a Task/Incident in ServiceNow is created or a work note is added, a ticket will be created in Halo, or the linked ticket in Halo will have the work note added. Attributes of the ticket created in Halo will determined by the configuration against the Customer/Supplier. </span></p><p><br></p><p><span style="font-size: 11pt;">The Halo integrator is used to pull updates to fields in ServiceNow into Halo. It will also act as an additional failsafe for webhook functionality, creating new tickets and work notes/comments if these have not been created in Halo. </span></p><p><br></p><p><span style="font-size: 11pt;">This is enabled under Configuration > Integrations > ServiceNow.</span></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjA5OTc4YTc0LTE3Y2MtNGNjYy04OTM3LTMzYTk0OGZjNmM5MCJ9.Vr-d_j32D51nX0c_lVymTB2EgapFlQ06kKZInFyIBLY" class="fr-fic fr-fil fr-dib" width="1013" style="width: 1015px; height: 513.049px;" height="513"></p><p><strong>Fig 18. Enable the Halo integrator </strong></p><p><br></p><p><span style="font-size: 11pt;">The integrator will run on a daily basis and will pull in any updates since the last scan, this includes updates to any of the mapped fields, or newly added work notes or comments.</span></p><p><br></p><p><span style="font-size: 11pt;"><em><strong>Note: Only tickets that have been created by Halo will have updates from ServiceNow synced back to Halo. </strong></em></span></p></div>
