Dispatch Centre Configuration - Microsoft Graph
Purpose
Microsoft is moving away from SMTP. Their lastest technology to send email uses Microsoft Graph with Modern Authentication.
In order to send email through Microsoft Graph you will need to setup a Microsoft Azure Entra Id application in a directory linked to their domain. This will allow your Office 365 users in your domain to send email from Argos Dispatch Centre using Microsoft Graph email.
Larger organisations may prefer to customise the setup of their Azure application including locking down which users in their domain can send email using the Microsoft Entra Id application.
Access
Login to the above website.
Setup Steps
In Microsoft Azure, search for Microsoft Entra Id:
After selecting Microsoft Entra Id select Add Application Registration:
Register the Application
Register the application with the following settings:
Adding a Publisher is not required but some clients may choose to add it:
Set to accounts in our organizational directory - single tenant to authenticate.
Secret
Configure a secret by selecting New client secret:
Select a secret expiry. Note the maximum expiry that can be selected is 24 months. Take note of the expiry date and create a new client secret to use with dispatch centre before that date:
Copy the secret value before leaving this page as once you leave the page the secret value can not be read:
This is what is displayed when you leave the page:
API Permissions
Next setup the API permissions by selecting Add a permission:
Select Microsoft Graph:
Select Application permissions:
Select Mail.Send:
Remove default permissions so only Mail.Send remains:
Select Grant admin consent ... for the client (for Argos "Grant admin consent for Argos Financial Systems" is displayed):
This is how the API permissions should look:
Overview Page
Along with the client secret the Application (client) ID and Directory (tenant) ID obtained from the overview page is required by Dispatch Centre:
Microsoft Graph Server Setup
Microsoft Graph Settings
| Field | Explanation |
Email Protocol | Microsoft Graph |
Error Notification Email | Enter the email address that any dispatch centre failed recipient errors should be sent to A separate email address is to be used for this to make rejections easy to recognise |
Reply to Address | Enter the email address you want the recipient to reply to This address shows as the sender in the recipient's email This may be the same as the Username |
Application (Client) ID | Enter the Application (Client) ID from the Entra ID Application Overview page in Microsoft Azure |
Directory (Tenant) ID | Enter the Directory (Tenant) ID from the Entra ID Application Overview page in Microsoft Azure |
Client Secret Value | Enter the Client Secret Value created in Microsoft Azure when setting up the Entra ID Application |
Username | Enter the Username email address |
Protocol |
Important Note:
The Email exception errors may be sent to the email account associated with the server username or to the Reply to Address. This will be dependent on the server setup.
Once the dispatch centre control details have been set up you must run the following tests so you know exactly how your errors are being reported.
- Email a communication to an address you have access to that is different from the ones entered above. Check the email is processed correctly and that you receive it.
- Attempt to email a communication to an address that does not exist. E.g. doesnotexist@argos.co.nz .
- Attempt to email a communication without entering an email address.
In the above cases you should receive either the email or an email notifying you of the error.
Dispatch Centre Service Settings
These settings will determine how often and/or when a check will be made for communications with a status of Ready to Send
Any communications with that status will be dispatched automatically
Field | Explanation |
Scheduled/Manual | Checking this option will allow you to run the dispatch centre manually from within the application or from a Windows Scheduled Task |
Predefined Interval | Check this option if you intend to run the dispatch centre continually as a service. |
Interval (in minutes) | This field is enabled if the Predefined Interval Service Setting has been checked This indicates the polling interval when dispatch centre is running as a service The interval entered here is always in minutes, we recommend a setting of 10 minutes |
Dispatch Centre Path | [F2] to browse for the folder containing the instance of Dispatch Centre required for this database For example c:\ArgosApps\DispatchCentre A single instance of Dispatch Centre is required for each different database you run |
Related Articles
Dispatch Centre Configuration - Gmail APIs
Purpose To setup the Gmail API service within the Gmail Admin portal Access https://console.cloud.google.com/ Login to the above website. Create the Project In the search bar enter Projects. Select the Create a Project option. Complete the Project ...Dispatch Centre
Purpose Dispatch Centre allows Communications to be sent by email Concepts Client Contact Points The Client Contact Point contains the client details required for dispatching communications by email. If no Active Client Contact Point record is found, ...Dispatch Centre Errors
Purpose Resolve any errors that arise during the Communications Dispatch process Access An email will be sent to the Dispatch Centre error notification email address which contains the error message and the internal number of the communication ...Communication Type Details - HTML Email
Access Communication Types Browse | or | Edit/View Communication Types | or HTML Email The HTML Email text needs to be created as a .html file and saved in a location that all users can access. HTML emails support the following communication ...Argos Vault Release Notes V5.146
Release Completion Date: 30 August 2024 Please disregard the release notes for the modules you do not use. Unless otherwise indicated, more detail about any change will be included in the relevant dialog [Help] button. Other documents referred to in ...