Microsoft 365

Microsoft 365 Email Integration

Microsoft 365 integration is used for sending and receiving email. This is performed via a Microsoft App registration that is created in your Azure tenant (by you), and HelpMaster will use this app account to send email. Your Azure administrator will need to create this “app registration/account” and give it permission to send email on behalf of users in your Azure tenant. Once this has been created and configured, you will need to copy the app configuration details from your Azure tenant and copy them into the HelpMaster System Administration > API Integrations > Microsoft 365 tab so that HelpMaster can use it.

Step 1 - Create and configure your Microsoft 365 “HelpMaster App”

  1. Log in to your Microsoft Azure Portal at https://portal.azure.com with an administrator account
  2. Navigate to Azure Active Directory > App Registrations
  3. Click New registration
  4. Enter a name. eg. HelpMaster
  5. Select “Accounts in this organizational directory only (Your org - Single tenant)
  6. Click Register to create the app registration azure app registration

Once the app has been created, you need to configure what Graph API permissions it will have access to. HelpMaster requires it to have access to read the user account and to be able to send and receive email.

  1. Click View API Permissions (if you’re still on the initial screen, or API Permissions from the left-side menu)
  2. Click Add a permission
  3. From the “Request API permissions” panel, click the top panel “Microsoft Graph
  4. Click Application permissions
  5. From the “Select permissions” list, scroll down to the “Mail” section and expand it
  6. Check Mail.Read and Mail.Send
  7. Scroll down to the “User” section and select User.Read.All
  8. Click Add permissions azure api permissions

Once the API permissions have been granted to the HelpMaster app, you need to grant consent to use the app within your Azure tenant.

  1. Click Grant admin consent for [Your Organization] link and click Yes to the confirmation prompt azure admin consent

Finally, in order to be able to use the app within HelpMaster, you need to configure a “Client Secret” for the app.

  1. Click Certificates & secrets from the left-side menu
  2. Click New client secret
  3. A dialog box will appear prompting for a name for the secret. This is a descriptive label only - it isn’t the secret. Enter the descriptive name and set the expiry to your preference. Note that if a secret expires, any code/apps/APIs using this app (Including HelpMaster) will stop working, and you’ll need to create a new secret and re-enter this value into the configuration within HelpMaster. Click Add azure client secret
  4. Copy the secret from the “Value” column - click on the copy icon, or select and copy manually. You may wish to save the secret somewhere safe, or just keep it on the clipboard to paste into HelpMaster. azure copy secret

Your Microsoft 365 HelpMaster app is now ready to be used by HelpMaster. The final step is to copy the configuration settings from your Azure portal into HelpMaster.

Step 2 - Configure the Microsoft 365 settings in HelpMaster

Working in the HelpMaster Desktop application, navigate to Administration menu > System Administration toolbar button > API Integrations > Microsoft 365

  1. Copy the Application (client) ID, Directory (tenant) ID and Client secret from Azure to HelpMaster in the corresponding text boxes
  2. Click Test Settings to ensure that authentication and configuration is correct
  3. If you get a “Microsoft 365 Authentication was successful” message box, click Apply to save your configuration system integration

Once this step has been completed successfully, create or edit a HelpMaster email account that uses this Microsoft 365 connection. See Global Email Accounts

See also

Register an application with the Microsoft identity platform