Service Messaging
The Service Messaging functionality enables the tracking of responses from emails within Service Requests within the Service module.
When a User responds to an email notification, the content of the email, along with any attachments will be added as a note to the Service Request (SR). This includes manual emails sent from within the SR, and emails generated from rules.
Further actions which can then take place include:
- Once a note is added to the SR, the status of the SR can be updated to a specific status to reflect the notification.
- Any attachments added to the email response will be added to the SR under attachment region within ‘Other’ folder.
- The system will record within the history of the SR, the note was created as a response to the email.
Microsoft Graph API is used to facilitate the sending and receiving of emails with the desired domain/tenant and mailbox .
The system will send and receive emails using an O365 mailbox (not Shared Mailbox) using OAuth 2.0 - SMTP Authentication.
All prerequisites and set-up are detailed in this document. This document outlines the four step to configure this functionality.
M365 Entreprise Application (your tenant)
The following configuration will need to be undertaken by your MS Entra administrator -
1. Enterprise Application.
An Enterprise Application is required within the O365 tenant to ensure the appropriate authentication to receive and send emails.
a. Within Manage Microsoft Entra ID, go to Enterprise Applications, ‘Create your own application’. Specify option ‘Integrate any other application you don’t find in the gallery (Non gallery)
b. Once the application is created, assign the appropriate users and groups as required.
c. Grant the following API Permissions
Manage > API Permissions – configure the following Microsoft Graph permissions :-
Mail.ReadBasic.All – Delegated
Mail.Send – Delegated
User.Read.All – Delegated
Mail.ReadWrite - Delegated
Tenant-Specific Policies - please be aware that Conditional Access, Security Defaults, or other custom policies may:
- Override or restrict access to Graph API.
- Block authentication or token issuance.
If issues occur we may need to review permissions. As recommended, this is a general guideline for permissions and may not be applicable in all environments based on these factors.
Please note Multi-Factor Authentication (MFA)
Can be enabled. This should be Fully compatible with delegated permissions when using OAuth 2.0 authentication flows
Please note at this point, from App Registrations,
Overview > Application (client) ID
Overview > Directory (tenant) ID
Manage > Certificates & Secrets > Client secrets > Value
MCS - Account Configuration
Within your MCS Client, go to Administration > Mail > Accounts > Email
1. The O365 account can must be set as ‘Default’ to allow the sending and receiving of emails for all default emails.
Go to Administration > Mail > Accounts > Email
Enter the email address.
Enter the incoming and outgoing port values will default to 143/587. Incoming and Outgoing Host values will default to smtp.office.365.com.
Set ‘Default’ as ‘Yes’ is you require this email to be the default email for your system. Other mailboxes can be configured here but only one mailbox can be selected as the ‘Default’ for your system.
2. Service Messaging must be enabled
Set ‘Service Messaging’ as ‘Yes’
3. 0365 tenant details
Add details from the Enterprise application configured to include:
Directory (tenant) ID
Application (client) ID
Client Secret Value
MCS – Note Configuration
Within your MCS Client, go to Administration > General > Type
A Service Request Note Type must be configured. This must have a code of ‘PUBLIC’. We recommend that the Access Level is set to ‘User’ only.
MCS – Mail Template – Reply Text
Within your MCS Client, go to Administration > Mail > Templates
Within your mail template settings, the reply to text must be set with the text
##- Please type your reply above this line -##
#EC_ID#
This can be added using the ‘Set Example text’ button within but will be set by default.
This text will appear at the top of each email sent. It is important that this text is not disturbed upon reply as this is critical to the system validating the identity of the Service Request relating to the email.
For configuration purposes, the text ‘Please type your reply above this line ‘ can be changed between the hash tags ##- Please type your reply above this line -## if needed but #EC_ID# must always remain.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article