To configure email communication channel there are two types of authentication
| Table of Contents | ||||
|---|---|---|---|---|
|
Basic Authentication
To setup basic authentication all we need is :-
IMAP URL
Gmail - imaps://%s:%s@imap.gmail.com/INBOX
Outlook - imaps://%s:%s@outlook.office365.com/INBOX
Port number (IMAP with SSL/TSL is assigned to port number 993)
Username (email address)
Password (Login / Application password)
Note that if the email account has 2FA enabled then application password is required to connect with the email client (Gmail / Outlook)
How to setup communication channel with basic authentication.
Click on the “Create communication channel” button, select communication channel type "Email," add a name, code, default inbox, and SLA.
...
Click on “Next step”, and then add basic authentication details
...
At last, click on "Finish." The system will start polling emails from the email account in 2 minutes.
OAuth2.0
OAuth authentication is different from basic authentication, and for that, some configuration needs to be done in the respected cloud platforms, for example, Outlook → Azure.
Outlook account
|
To start using an Outlook email account, a one-time configuration needs to be done first in Azure.
...
Tenant (Realm / Directory Id)
Client Id (Application Id)
Client secrets
Username(username can be any email address that you want the system to listen to new incoming emails).
Step-by-step guide to configure Azure account
Register Application
Login to your organizations Azure account.
Select Azure Active Directory in the left-hand navigation, then select App registrations under Manage.
Select New registration. On the Register an application page, set the values as follows.
Set Name to a friendly name for your app.
Set Supported account types to the choice that makes sense for your scenario.
For Redirect URI, set the value that is shown in the MXTS Communication Channel page.
Redirect URI - https://<concern-code>.maxxton.net/customercare/en-us/azure-oauth-callback.html
Choose Register. On the next page, copy the values of the Application (client) ID and Directory (tenant) ID and save them, you will need them later.
...
Copy the values of the Application (client) ID and Directory (tenant) ID and save them,
...
API Permission
Once the app is registered, then provide the API permissions that are required: -
...
The API permission requires admin consent if you yourself don’t have admin rights.
Generate client secrets
Once the API permissions are added to the registered application, it's time to generate the client secrets.
...
Once Register Application, API Permission and Generate client secrets all three of this steps are completed you can start setting up outlook account in the communication channel.
...
...
Setup communication channel (Video)
Below is the step-by-step video guide
...
for “How to setup Email (Azure / Outlook ) communication channel
...
TODOtype.”
...
References
...