<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><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><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><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 id="isPasted"><strong>- Pre-Requisites</strong></p><p><strong>- Supported Mailboxes</strong></p><p><strong>- Initial Setup</strong></p><p><strong>- Authentication Method</strong></p><p><strong>- Credential Types</strong></p><p><strong>- Processing Method</strong></p><p><strong>- Configuring an Azure Application</strong></p><p><strong>- Creating Credentials</strong></p><p><strong>- Connecting to the Mailbox</strong></p><p><strong>- Imports</strong></p><p><strong>- Logging</strong></p><p><strong>- Common Errors</strong></p><p><br></p><p><br></p><p>In this guide we will cover Office 365/Azure mailboxes in Halo, including how to set these up to allow the ingestion of emails into a mailbox of this type to create tickets in Halo. If you are looking to connect a mailbox of a different type ensure you use the guide dedicated to that mailbox type, such as:</p><ul><li style="font-weight: bold;"><a href="https://usehalo.com/haloitsm/guides/1521/" rel="noopener noreferrer" target="_blank"><strong>Google</strong></a></li><li style="font-weight: bold;"><a data-fr-linked="true" href="https://usehalo.com/haloitsm/guides/875/" id="isPasted" target="_blank" rel="noopener noreferrer">IMAP/POP3/EWS</a></li></ul><p><br></p><p><strong><span style="font-size: 14pt;">Pre-Requisites</span></strong></p><p>1. The incoming service must be enabled in your instance. This is activated for all hosted customers automatically. </p><p><br></p><p style="margin-left: 20px;">If you are On-Prem and the service is not yet active in your instance, and you are unsure of the implications of activating it, please contact your account manager or the Halo support team. </p><p style="margin-left: 20px;"><br></p><p style="margin-left: 20px;">To check whether the service is currently enabled, navigate to Configuration > Advanced Settings > Backend Services, check that the incoming service checkbox is on and that the scheduling service is set to yes.</p><p style="margin-left: 20px;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImEwNjczNGM5LWI2MTAtNDVmMi1iYjY1LTE2NzBhZjdjMDcyYiJ9.KdZfxpu8S_upc0evIFWnkctjzdj30PlFOzT65N1GrmM" class="fr-fic fr-fil fr-dib" width="743" style="width: 745px; height: 426.1px;" height="426"></p><p style="margin-left: 20px;"><strong><span style="font-size: 10pt;">Fig 1. Incoming Service enabled.</span></strong></p><p><br></p><p><span style="font-size: 11pt;">If you are an On-Prem (self-hosted) customer please see <a data-fr-linked="true" href="https://usehalo.com/haloitsm/guides/2437" id="isPasted" target="_blank" rel="noopener noreferrer">Creating a Mailbox Overview</a> for the pre-requisites you will require for connecting a mailbox to Halo. </span></p><p><br></p><p><strong><span style="font-size: 14pt;">Supported Mailboxes</span></strong></p><p>Halo can connect to licensed and shared mailboxes. All other kinds of mailboxes are currently unsupported.</p><p><br></p><p><strong><span style="font-size: 14pt;">Initial Setup</span></strong></p><p>To begin setup you will need to create a new mailbox in Halo with the mailbox connection type 'Office 365/Azure'. To do this head to Configuration > Email > Mailbox > New, give the mailbox a name and set the mailbox connection type as 'Office 365/Azure' and save. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImZhMzc3YzI2LTgzZTAtNDYzZS04YzIzLTE1NDk5MGYwYmM1OSJ9.pKEo1b5ecRRQoUuqbQxffqMfuStY3Ir8xPnS2PE_X2s" class="fr-fic fr-fil fr-dib" width="1101" style="width: 1103px; height: 663.727px;" height="664"></p><p><strong><span style="font-size: 10pt;">Fig 2. Office 365/Azure Mailbox connection.</span></strong></p><p><br></p><p>Now you will need to setup the credentials to connect this mailbox. To begin hit the 'Credentials' button then hit 'new'. Here, you will be given various options to determine how the connection between Halo and your mailbox is authenticated. </p><p><br></p><p><strong><em>Note: You will notice it is possible to configure multiple sets of credentials here, this is to allow you to configure credentials for another mailbox (of the same type) to be used in a different (UAT/Dev) instance. So a single Halo mailbox can contain credentials to access multiple Azure mailboxes. Each of these mailboxes will be linked to your production, UAT or dev instance, each instance will then only process the mail in the mailbox the associated credentials give access to. For more information checkout <a data-fr-linked="true" href="https://usehalo.com/haloitsm/guides/2437" id="isPasted" target="_blank" rel="noopener noreferrer">Creating a Mailbox Overview</a>.</em></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjI2MDkzODBjLWU5NDItNDZmYi04NmNhLWRmMjA0MmVjN2MxNiJ9.OpOu1npx0o1G2f41ZIc4_eMm3RBD3oN8ygr0woWJsuA" class="fr-fic fr-fil fr-dib" width="1194" style="width: 1196px; height: 436.604px;" height="437"></p><p><strong><span style="font-size: 10pt;">Fig 3. New mailbox credentials.</span></strong></p><p><br></p><p>First, choose the instance you would like mail from this mailbox to be processed into using the 'Instance' field. If you do not have a testing UAT/Dev environment you will only be able to choose Production here. For more information on instance management checkout <a data-fr-linked="true" href="https://usehalo.com/haloitsm/guides/1888" id="isPasted" target="_blank" rel="noopener noreferrer">Configuration Change Tracking & Instance Management</a>. </p><p><br></p><p><strong><span style="font-size: 14pt;">Authentication Method</span></strong></p><p>Now you will need to choose the Authentication Method for the mailbox, options here include 'Authorisation code' and 'Client Credentials'<img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE2MTU5ZjFlLTNhOTktNDY5MS1hZWZmLTRkZTNmZDNjNGI4YSJ9.xvilzcYMOLKHRPJZ2UgvnTx0rOM4e1YNzAKcYXPFV8U" class="fr-fic fr-fil fr-dib" width="554" height="191"></p><p><strong><span style="font-size: 10pt;">Fig 4. Authentication methods for mailbox.</span></strong></p><p><br></p><p>These use different permission types within the Microsoft Graph API (Delegated vs Application). For information on the difference between Delegated and Application permissions, checkout <a data-fr-linked="true" href="https://learn.microsoft.com/en-us/graph/permissions-overview?tabs=http" target="_blank" rel="noopener noreferrer">Microsoft's guide here.</a></p><p><br></p><p>If unsure which authentication method to use, Application Permissions (used by the Client Credentials method) are the simplest, feature-rich and most stable option. </p><p><br></p><p><strong><span style="font-size: 12pt;">Authorisation Code </span></strong></p><p>This authentication method uses Delegated permissions within the Graph API.</p><p><br></p><p>It should be noted when using this authentication method, you will only be able to process mail using the 'Mailbox Scan'. This can take up to 5 minutes to be processed by Halo after being received into the mailbox vs the almost instant processing under the 'Webhook' method. </p><p><br></p><p><strong><span style="font-size: 12pt;">Client Credentials</span></strong></p><p id="isPasted">This authentication method uses Application permissions within the Graph API.</p><p><br></p><p>When using this authentication method you will be able to process mail using either the 'Mailbox scan' method or the 'Webhooks' method. This authentication method also allows you to use 'Federated credentials' to authenticate the connection if your instance is On-Prem. </p><p><br></p><p>There are additional security steps that are recommended when using this method, which are outlined in more detail later on.</p><p><br></p><p><strong><span style="font-size: 14pt;">Credentials Types</span></strong></p><p>Once you have chosen your authentication method you will need to choose the credential type you would like to use to authenticate the connection. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQxZGM1ZjBlLTNlYTgtNGYxNS05ZGI1LWJmOGY0MWUxNTEzNyJ9.a4Tv3S6dklUTzmY7a5kun4TG45DLutK5N_TvR4gsHPs" class="fr-fic fr-fil fr-dib" width="631" height="293"></p><p><strong><span style="font-size: 10pt;">Fig 5. Available credential types.</span></strong></p><p><br></p><p><strong>Client Secret</strong> - When chosen you will need to generate a secret for the Azure application you setup. This will be used to authenticate the connection.</p><p><strong>Certificate</strong> - When chosen you can use a X.509 certificate to authenticate the connection. </p><p><strong>Federated credentials (On-Prem only)</strong>- When chosen, you can setup and use federated credentials from your Azure to authenticate the connection. </p><p><br></p><p>We will outline how to configure the mailbox using a Client Secret in this guide. If you wish to use one of the other two methods, please see this guide: <a data-fr-linked="true" href="https://usehalo.com/haloitsm/guides/2446" target="_blank" rel="noopener noreferrer" id="isPasted">Authentication Methods for Microsoft Integrations</a>. </p><p><br></p><p><strong><span style="font-size: 14pt;">Processing Method</span></strong></p><p>Now you will need to choose the method you would like to use to process emails from this mailbox. This is set in the 'method' field, there are two options here 'Mailbox scan' and 'Webhooks'.</p><p id="isPasted"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjBkN2U4Y2NlLTJhMTYtNDM4Yi04YTYzLTgzNWJlYTEzZGRkNiJ9.ybXCat6V51o51BkJPAV8B-r21qvOSzKidWCLppiiRlI" class="fr-fic fr-fil fr-dib" width="656" height="337"></p><p><strong><span style="font-size: 10pt;">Fig 6. Method for processing mail.</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Mailbox Scan </span></strong></p><p>The task scheduling service (which is automatically enabled when the incoming service is enabled) will scan the mailbox every 3-5 minutes to process mail (so it can take up to 5 minutes for mail to be brought from the Exchange mailbox into Halo).</p><p><br></p><p><strong><span style="font-size: 12pt;">Webhooks (Recommended Method)</span></strong></p><p>When using this method a webhook from Azure with the email content is sent to the Halo API when an email is received in the mailbox, providing instant delivery and processing of any emails that are received. The task scheduling service that is also used for the mailbox scan will also run to retry any potential failed webhooks, but the frequency of this scan will be decreased.</p><p><br></p><p><strong><span style="font-size: 14pt;">Configuring an Azure Application</span></strong></p><p>Once you have selected the method you would like to use for processing emails, you must configure an application in Azure before continuing with any further Halo configuration. Setup steps for both methods are outlined in this section.</p><p><br></p><p>Start by navigating to the Azure portal and select New Registration in the App Registrations. There are three required fields on the creation screen:</p><p><br></p><ul><li>Name - Give your application a sensible name so it can be easily referred to later.</li><li>Supported account types - Must be single-tenant. Multi-tenant is not supported and will cause issues later.</li><li>Redirect URI - Only required if you are using Mailbox Scan as the method. <ul><li>If you are on a version prior to v2.182 the platform should be "Web" and the URL should be your Halo application URL followed by /azure/auth. For example, <a data-fr-linked="true" href="https://myapp.haloitsm.com/azure/auth">https://YOURHALODOMAIN.com/azure/auth</a>. </li><li> If you are on version v2.182+ the platform should be "Web" and the URL should be your Halo application URL followed by /authcallback. For example, <a data-fr-linked="true" href="https://myapp.haloitsm.com/authcallback">https://YOURHALODOMAIN.com/authcallback</a>. </li></ul></li></ul><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQ3ZDE5MmI4LTIzZGYtNDk0YS1iMjg5LTI4NTFhZWZkOTFmNyJ9.MzZWTppokDwo4TU156AEG84So0s5bdZegC-9f9ApUtw" width="638" style="width: 638px; height: 476.813px;" height="476.813" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 7. Creating an application.</span></strong></p><p><br></p><p>Once registered, take note of the Application (client) ID on the overview tab, as well as the Directory (tenant) ID. These values will be needed later.</p><p><br></p><p>The next step is to add the relevant permissions to the Azure app. As previously mentioned, the required permissions will depend on the authentication method that you have selected, the exact permissions you need will show in Halo after selecting the authentication method/credential type/processing method you are using. </p><p><br></p><p><strong><span style="font-size: 12pt;">Permissions when using Authorization code to authenticate</span></strong></p><p id="isPasted">Required Microsoft Graph API Permissions (Delegated):</p><ul><li>Mail.ReadWrite</li><li>Mail.Send</li><li>offline_access</li><li id="isPasted">Contacts.Read (only required if you would like to import contacts in Outlook as users in Halo) </li><li id="isPasted">Mail.ReadWrite.Shared (only required if using a shared mailbox)</li><li>Mail.Send.Shared (only required if using a shared mailbox)</li><li>Contacts.Read.Shared (only required if you would like to import contacts in Outlook as users in Halo and you are connecting a shared mailbox) </li></ul><p> </p><p><strong><em>Note: For Shared Mailboxes, the account used to authorize will also need delegate access to the Shared Mailbox in Microsoft 365.</em></strong></p><p><br></p><p id="isPasted"><strong><span style="font-size: 12pt;">Permissions when using Client Credentials to authenticate</span></strong></p><p id="isPasted">Required Microsoft Graph API Permissions (Application):</p><ul><li><span style="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-align: left; 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; display: inline !important; float: none;">Mail.ReadWrite</span></li><li><span style="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-align: left; 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; display: inline !important; float: none;">Mail.Send</span></li></ul><p>If you would like to restrict the mailboxes the application has access to, do not provide the application with any permissions. You will need to setup Role Based Access Control (RBAC), all permissions and access will need to be configured within the role. For more information see the section "Additional restrictions (Client Credentials authentication method only)".</p><p><br></p><p><strong><span style="font-size: 12pt;">How to add permissions to the application</span></strong></p><p>1. Navigate to the API permissions tab and select Add a permission.</p><p><br></p><p>2. Select Microsoft Graph as the API.</p><p><span style="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-align: left; 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; display: inline !important; float: none;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImMwMzcwZmVhLTFiZTAtNDIzMi1iZDE0LWY4YWM0NTg4ODY3OCJ9.mv3LOt3EOOyTePy4Dr3_VBnpeBSTk_xx0YyELXoncew" width="1096" style="width: 1096px; height: 340.492px;" height="340.492" class="fr-fic fr-dii"></span></p><p><br></p><p><strong>Fig 8. Selecting the API.</strong></p><p><br></p><p>3. Choose the type of permission depending on the method you are using. Choosing an incorrect permission type will prevent you from fully configuring the mailbox later in Halo.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImMwOTllYTE4LWI4NjEtNDk0OS1iMTA4LWFlNzljYWFlZTQ3MCJ9.uVtV63I86YEZakJ4c4KUrMaK_y-ULl1fJ9zOn1zXI_I" width="621" style="width: 621px; height: 200.933px;" height="200.933" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 9. Choosing the type of permission.</span></strong></p><p><br></p><p>4. Search for the permissions, and select the necessary permissions that are required.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjBkODk5YWI5LTRjMjQtNDdiNy1hZjUwLTAwNGY4NzE0NDRiZiJ9.INCMr2sAGZFLgTRBg3YiPEogxK5s-X4IBmEctTpYg-M" width="655" style="width: 655px; height: 527.83px;" height="527.83" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 10. Selecting permissions.</span></strong></p><p><br></p><p>5. Once added, grant admin consent for the tenant:</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJmOGE0ZjMyLTJmMDktNGVlOS04MzI2LWQwODBjMDQzOGI1ZiJ9.EwQ56YI7Yq4ADKMtBVFd__jBZA367vF5JO7rGcRzupY" width="791" style="width: 791px; height: 252.936px;" height="252.936" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 11. Granting admin consent.</span></strong></p><p><br></p><p id="isPasted"><strong><span style="font-size: 12pt;">Additional restrictions (Client Credentials authentication method only)</span></strong></p><p>If you are using the Client Credentials authentication method, it is highly recommended that you create an application access policy or configure Role based Access Control to restrict which mailboxes your Azure application can access. Without this, the application will be able to access all mailboxes within the Azure tenant. Restrict this to the mailboxes you would like to integrate with Halo. </p><p><br></p><p><strong><em>Note: Halo supports both methods, however, application access policies are due to be deprecated by Microsoft therefore for new setups we advise using Role Based Access Control.</em></strong></p><p><br></p><p>Access policies are not needed when using the Authorisation Code authentication method as this method uses delegated permissions. When using delegated permissions the mailboxes the application will have access to will be determined by the mailboxes the user permissions are being delegated from has access to. If you would like to ensure only specific mailbox are accessed, ensure the user permissions are delegated from only has access to these mailboxes. </p><p><br></p><p><strong>Application Access Policies </strong></p><p>Application Access Policies allow you to restrict down the mailboxes the application can access. These restrictions will override the permissions the application already has, so you will still need to provide the application with permissions. Application access policies will be deprecated by Microsoft and they instead advise to use Role Based Access Control going forward. Existing policies will still be supported. </p><p><br></p><p>To find out more about how to add an application access policy, see Microsoft's documentation: <a data-fr-linked="true" href="https://learn.microsoft.com/en-us/powershell/module/exchangepowershell/new-applicationaccesspolicy?view=exchange-ps">https://learn.microsoft.com/en-us/powershell/module/exchangepowershell/new-applicationaccesspolicy?view=exchange-ps</a>.</p><p><br></p><p><strong>Role Based Access Control (RBAC)</strong></p><p>RBAC can be used to restrict the mailboxes the application can access. When using RBAC do not provide the application with any permissions, all permissions (and access) will be granted by the configured role.</p><p><br></p><p>For information on setting up RBAC see Microsoft's documentation: <a data-fr-linked="true" href="https://learn.microsoft.com/en-us/exchange/permissions-exo/application-rbac" data-pasted="true" target="_blank" rel="noopener noreferrer">Role Based Access Control for Applications in Exchange Online</a>. </p><p><br></p><p><strong><span style="font-size: 12pt;">Generating the Client Secret</span></strong></p><p id="isPasted">To obtain a secret for your Azure Application, head to the Certificates and Secrets tab within the application you have created. Generate a new secret with a sensible expiry date. Make a note of the value generated and the expiry date. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQ3ZDc0NTdlLWQzNzgtNDI0NS1hMTAzLTZjNzg3YTcwZDMwZiJ9.Ydv7ODOv_-xkqDH7hg3GBWDLwpDh2-O8LdXQXPgLa-o" width="918" style="width: 918px; height: 488.253px;" height="488.253" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 12. Creating a secret.</span></strong></p><p><br></p><p><strong><span style="font-size: 10pt;">Note: The secret value is required not the secret ID.</span></strong></p><p><br></p><p><span style="font-size: 11pt;">Once you have the secret head back to Halo and paste this into the 'Azure Application Secret' field. </span></p><p><br></p><p><strong><span style="font-size: 14pt;">Connecting to the Mailbox</span></strong></p><p>Once you have successfully created your Azure application and credentials, you can now add the details to the mailbox configuration in Halo and complete the rest of the setup.</p><p><br></p><p>The fields shown in figure x must be completed and the mailbox must be saved before continuing, regardless of the chosen method. The Microsoft Graph Global Service should always be chosen as the authority unless you know that your Azure tenant uses a different authority.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFiMGE0ZDE1LTM2Y2YtNGQ1NC05OTdiLWNiMzkxNWE4ZGQzNCJ9.y3dpjAmYvJ3WEbG6H9sJeVOAiZuxTFKN91g_F7Qn2wE" class="fr-fic fr-fil fr-dib" width="707" height="400"></p><p><strong><span style="font-size: 10pt;">Fig 13. Configuring the mailbox in Halo.</span></strong></p><p><br></p><p>If you are using the Authorization code as the authentication method, then an option to configure a shared mailbox is also available. If the mailbox you are connecting is a shared mailbox enter the address of the shared mailbox here. If you are connecting a licenced mailbox you can leave this field blank. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjIwYjI4OGE4LTYwNWYtNGI4MC04NTY1LTVmYTcxOTBjYTQyYyJ9.8K8-MIcHZHvz-_tUIzWxLhkJtbJtbzXmcBL-iM1gtQA" width="543" height="116" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 14. Shared mailbox option.</span></strong></p><p><br></p><p>If you are using Client Credentials, then an email address field is available. This field can accept licenced or shared mailboxes. The only additional requirement is that the owner of the email address must have a UPN value that matches the email address.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImEzZTQ0NWE2LThkOTQtNGY3Ni1hMGZjLTE4ZTMyMzAzODljOCJ9.bWN9bJfuDsx0efPNJrSJsBSSYJyHGj4C_HbpLNrf44Y" width="537" height="98" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 15. Email address option.</span></strong></p><p><br></p><p>Once saved, you will need to complete connection. Follow the next subsections based on the connection type you are using. </p><p><br></p><p><strong><span style="font-size: 12pt;">Mailbox Scan</span></strong></p><p>If using the mailbox scan method, click the Authorize Application/Sign in button to initiate a sign-in flow with Azure. Be aware that the user who completes the sign-in flow will have the emails from their inbox processed. A warning will alert you to this before proceeding.</p><p><br></p><p><strong><span style="color: rgb(226, 80, 65);">Important: Incorrect configuration can mean that your personal mail <strong id="isPasted">(john.doe@microsoft.com) is processed into Halo as tickets. Further details are provided below to ensure proper setup.</strong></span></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjBlM2E2YmUyLTdkYTAtNDhmMi1iZTFhLTQ2YzAyYWUwNmYxZSJ9.MSiXOPUIM-JDl3tljBcbxLiQLhijuGGq8oIu3Otfbxc" width="631" height="109" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 16. Warning message.</span></strong></p><p><br></p><p id="isPasted"><strong>If you are authorizing a licensed mailbox:</strong></p><p>Simply sign into your licensed mailbox using its username and password.</p><p><br></p><p><strong>If you are authorizing a shared mailbox:</strong></p><p>Ensure the "Shared Mailbox" field is populated the shared mailbox's full address.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE0MjFhZjdlLWQ2M2UtNDRjOC1iZjE0LTNmYTNhN2UzNzA4YSJ9.tVSpbvj-e_H92pB8U0swXiWAN3mkP8DLXjkemzl3PQM" class="fr-fic fr-fil fr-dib" width="584" height="109"></p><p><strong><span style="font-size: 10pt;">Fig 17. Shared mailbox.</span></strong></p><p><br></p><p id="isPasted">Ensure the licensed user is added as a delegate user on the shared resource with Read & Manage (Full Access) permissions.</p><p><br></p><p>If either of these have not been configured correctly, it is possible that Halo will try to ingest emails from the authenticating licensed account rather than the shared mailbox. In case of this improper configuration, it is advisable to disconnect the connection as swiftly as you can and review your configuration.</p><p><br></p><p>Once you are connected, the connected email address will be shown on the setup screen. All values will be locked in and can only be altered by using the disconnect button first.</p><p><br></p><p><strong><span style="font-size: 12pt;">Webhooks</span></strong></p><p>If using the webhooks method, you are not required to complete a sign-in. Instead, a subscription will be created for the chosen email address. Click the Create Subscription button to register the subscription. If successful, the details of the subscription will be displayed, including the subscription's expiry date. The subscription can be cancelled at any time using the Cancel Subscription button.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg5MThjNDRmLThjODctNDA0OC1hZTBkLWM2YjBhMjhkMTAxYSJ9.rmCMKJBgD0OZI3Z1C7q00BYeMI5J4izjAQNlwZMaRGY" width="539" height="132" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 18. Subscription displayed.</span></strong></p><p><br></p><p>The subscription expiry is always set to the maximum allowed value in Azure. It is automatically renewed whenever the expiry date is within 2 days of expiry, either during the processing of a webhook or by the task scheduler if no webhooks have been received to trigger the refresh. </p><p><br></p><p>From the moment the subscription has been created, webhooks will be sent to Halo from Azure to process any new emails received in the user's mailbox.</p><p><br></p><p><strong id="isPasted"><span style="font-size: 14pt;">Outbound Defaults</span></strong></p><p>After connecting the mailbox, if you are deleting your old mailbox that was the outgoing default you need to designate a new default. Navigate to the "Outgoing Email Defaults" found in Configuration > Email > General Settings, and change the default connection to the new mailbox. Without doing this step, you will not see anything populate in the email from field when emailing clients.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjUxYzdjNjQzLWI1ZGItNGRiNy05MDJjLTAyYzMwNDVkNWM0OSJ9.ymBuW22YLo5AJaBmkBIloNu0ANptA_IaGkLdIcMATks" class="fr-fic fr-fil fr-dib" width="218" height="165"></p><p><strong><span style="font-size: 10pt;">Fig 19. Outgoing email defaults.</span></strong></p><p><br></p><p id="isPasted"><strong><span style="font-size: 14pt;">Imports</span></strong></p><p><strong><span style="font-size: 12pt;">Manual Imports</span></strong></p><p>At the bottom of the incoming tab, it is now possible to import emails manually. </p><p><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg2OWE5MTdlLWM3MGMtNDk4NC1hOTg0LWE5YTA0NTYzNDRkMyJ9.lKHi-53eeD7hVlGaTkhC-i1SVMg1dufBYEhy21Hgyd0" width="411" height="215.322" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; max-width: calc(100% - 10px); min-width: 10px; color: rgb(0, 0, 0); font-family: Poppins, sans-serif, Roboto; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; 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: 411px; height: 215.322px;" id="isPasted" class="fr-fic fr-fil fr-dib"><br></p><p><br></p><p><strong><span style="font-size: 10pt;">Fig 20. Importing emails.</span></strong></p><p><br></p><p>After configuring a mailbox that is using the Mailbox Scan method, it is recommended that you attempt to click the Import Emails button. This will highlight any potential permissions issues (especially if using a shared mailbox) so that they can be rectified before signing off on your mailbox configuration.</p><p><br></p><p id="isPasted"><strong><span style="font-size: 12pt;">Contact Imports</span></strong></p><p>Once you have connected you will see an additional tab titled 'contact imports' this can be used to import contacts from Outlook as users in Halo, using the connected mailbox. </p><p><br></p><p>If using this functionality make sure you have the following permission to your Azure application:</p><ul><li>Contacts.Read</li></ul><p><br></p><p><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImY2MTRjOGRiLWI3ZTAtNGEyMC04ZWY1LWNkOGU0NDYyMTU4YyJ9.ruCC-LIls25bPSSRY7fb_vPRi7cCTYLSslshkYV_Rnc" width="1165" 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: Poppins, sans-serif, Roboto; 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: 1167px; height: 737.759px; max-width: none !important;" id="isPasted" class="fr-fil fr-dib" height="738"><br></p><p id="isPasted"><strong><span style="font-size: 10pt;">Fig 21. Contact imports.</span></strong></p><p><br></p><p>Before importing contacts you may want to create some contact mappings, this maps Outlook contact fields to user fields in Halo. To create a mapping simply use the 'Add' button to add a mapping to the table, select the Outlook field and Halo User field you would like to be associated, and hit save. New users that are created will be attempted to match to a site based on their email domain, if their domain cannot be matched to a site domain they will be assigned to the default site for new users. </p><p><br></p><p>The 'Import Contacts' button can be used to manually import contacts, but these can also be imported on a schedule using the Halo Integrator. The checkbox 'Enable the Halo Integrator for importing Outlook Contacts from this Mailbox Connection' on this tab must be checked for a scheduled sync to take place. </p><p><br></p><p><strong><span style="font-size: 14pt;">Logging</span></strong></p><p>As part of the new incoming service, it is now possible to see the log for every email that has been processed via the service. This can be found on the Inbound Log tab of the mailbox, or in Configuration > Advanced > Backend Services > Backend Service Monitoring.</p><p><br></p><p>Both screens allow you to see some basic information about the incoming email, and whether it was successfully processed.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc1MmU0YjBkLTkxN2EtNDExZC1iYzU5LTBhMDhjYTM2MDFjZSJ9.IETOfiPgIh3RzPUEDGSUwZg3hU3KJ7CRopP98UEXCjk" width="1100" style="width: 1100px; height: 228.942px;" height="228.942" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 22. Inbound log.</span></strong></p><p><br></p><p>By clicking on the record, more elaborate details about the email can be found, including the details of each processing attempt. This is located on the Requests tab. Each request can be opened, where the raw data for the request can be observed, as well as a detailed processing log for help understanding how an email has been processed.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZjOTYzYTBlLTJkOTAtNDIzZi1iZGFiLWRiYzc3MjYwY2RkZSJ9.qbKu_vGr1wjDFS7VxMyu8pxuFRDiRLNRFQhjGarFyZQ" width="1132" style="width: 1132px; height: 392.399px;" height="392.399" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 23. Details.</span></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE3NTI2NmMxLTYxNjAtNDFkMy05NWFlLTcxNDEyMTM4ZDM3NCJ9.0ydL1Ew9ZpRCOKTFuttS9uCigRrtDE6k5QKgfTK7vzQ" width="1135" style="width: 1135px; height: 516.951px;" height="516.951" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 24. Request.</span></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjcyZWQwNjQxLTEzNDQtNGIxOC04Mzg4LThjNzVjM2ZmNzI1OCJ9.KFDKKC8ayOwvpS224bgcMRnCCRVfjE7wXoWSReAtzNw" width="1135" style="width: 1135px; height: 571.884px;" height="571.884" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 25. Log.</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Error Notifications</span></strong></p><p>Send Error Notifications for emails and the Halo Integrator, to specific agents (Configuration > Teams & Agents > Agents > Click into an Agent > *Preferences Tab*).</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImY4YWZmZWMwLWI5YjMtNGY0Ny1iZjcyLWRjY2ZiZjU5NThiMyJ9.HPBzkPUBFr5PGWfcwZlZPWBqojB3ngAUpu5_-tcBSA4" class="fr-fic fr-fil fr-dib" width="1212" style="width: 1214px; height: 62.0575px;" height="62"></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQ2MTEyZTAwLTBlMmEtNDdhYS05YzM2LWEwYWFiNWUzNDAzYSJ9.q1HwMEU4OnVMtbk0QiRzM3CSAL6vWrdhRc1TVh-j7QU" class="fr-fic fr-fil fr-dib" width="584" height="126"></p><p><strong><span style="font-size: 10pt;">Fig 26. Notifications options.</span></strong></p><p><br></p><p><span style="font-size: 14pt;"><strong>Common Errors</strong></span></p><p>Here, we have outlined some errors that may occur around mail processing. If a mailbox stops working and no error below matches your issue, first try to Disconnect and then reauthorise the mailbox in Halo.</p><p><br></p><table class="styled-table grid" style="width: 100%;"><tbody><tr><td style="width: 48.7725%; text-align: left; background-color: rgb(0, 204, 248);"><span style="font-size: 11pt;"><strong><span style="color: rgb(255, 255, 255);">Error</span></strong></span></td><td style="width: 51.1541%; text-align: left; background-color: rgb(0, 204, 248);"><span style="font-size: 11pt;"><strong><span style="color: rgb(255, 255, 255);">Solution</span></strong></span></td></tr><tr><td style="width: 48.7725%;"><span style="font-size: 11pt;">Length Cannot Be less than zero (Parameter 'length')</span></td><td style="width: 51.1541%;"><span style="font-size: 11pt;">When this occurs, you must create a new secret and make sure to copy the "Value" when generating the secret, not the Secret ID. Make sure to store this "Value" somewhere safe as it is important and can't be copied again after you click off the app registration page.</span></td></tr><tr><td style="width: 48.7725%;"><span style="font-size: 11pt;">Error is not defined, and you are in doubt as of what to do </span></td><td style="width: 51.1541%;"><span style="font-size: 11pt;">Disconnect and then reauthorise the mailbox in Halo if in doubt</span></td></tr><tr><td style="width: 48.7725%;"><span style="font-size: 11pt;">Failed to retrieve agents - 400 Bad Request: "Token refresh failed - invalid_grant - AADSTS9002313: Invalid request. Request is malformed or invalid. </span></td><td style="width: 51.1541%;"><span style="font-size: 11pt;">reauthorise mailbox, if not working try regenerating the secret, make sure to copy the "Value" when generating the secret, not the Secret ID. Make sure to store this "Value" somewhere safe as it is important and can't be copied again after you click off the app registration page.</span></td></tr><tr><td style="width: 48.7725%;"><span style="font-size: 11pt;">Connection Failed for refreshing access token for mailbox ID 3 - AADSTS9002313: Invalid request. Request is malformed or invalid. </span></td><td style="width: 51.1541%;"><span style="font-size: 11pt;">Reauthorise mailbox, if not working try regenerating the secret, make sure to copy the "Value" when generating the secret, not the Secret ID. Make sure to store this "Value" somewhere safe as it is important and can't be copied again after you click off the app registration page.</span></td></tr><tr><td style="width: 48.7725%;"><span style="font-size: 11pt;">Emails not coming through to halo but mailbox is working and inbox is being emptied?</span></td><td style="width: 51.1541%;"><span style="font-size: 11pt;">Run Report “select top 100 * from incomingemail order by IEdatecreated desc” then do a ctrl + f for rule and check to make sure it isn’t being caught by an email rule, if it is, it will be evident on the report which email rule is binning off all emails. Emails can then be added back from the deleted folder (in your outlook account) to inbox and then they will be processed back into halo once placed into the inbox folder.</span></td></tr></tbody></table><p><br></p>
