Email Dialogue Provider Plugin Settings Overview
Note
An Enterprise license or higher is required to access these features.
Introduction
Below an overview of the available settings for the Email Dialogue Provider
Plugin Settings
General
Setting | Value | Default | Description |
---|---|---|---|
Type |
EWS or Graph |
EWS |
Use Exchange WebServices API ( https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/start-using-web-services-in-exchange ) or Microsoft Graph API ( https://docs.microsoft.com/en-us/graph/overview ) for the connection to the mailbox Warning EWS is no longer supported by Microsoft, for more information see: Exchange Online – September 2022 Update |
EmailAddress |
E-mail address |
The e-mail address of the mailbox. |
|
Enabled |
True or False |
False |
Enable the provider. |
PollingIntervalInSeconds |
Whole number greater than 0 |
15 |
Specify how fast the mailbox and database should be polled for new messages. |
PageSize |
Whole number greater than 0 |
10 |
Maximum number of messages to retrieve from the mailbox on each poll. |
TaskLimit |
Whole number greater than 0 or -1 |
4 |
Number of threads to use simultaneous when polling or -1 for no limit. 4 is the limit for Graph. |
PollTimeoutInMinutes |
Whole number greater than 0 |
5 |
Consider the current poll a loss after a set amount of minutes. This can happen for both EWS and Graph when the mailbox doesn't respond anymore. |
AttachEml |
True or False |
False |
Attach the entire e-mail message as an attachment which enabled the agent to open the e-mail in another mail client such as Outlook. Warning Activating this feature will require twice the storage capacity typically needed, as it effectively doubles the size of each message. |
SendAsSharedMailbox |
True or False |
True |
Send the e-mail as the shared mailbox's address ( https://docs.microsoft.com/en-us/microsoft-365/admin/email/create-a-shared-mailbox?view=o365-worldwide ) |
SpanStyle |
CSS |
Wraps the content of the e-mail in a span tag ( https://www.w3schools.com/tags/tag_span.asp ) and allows the styling using CSS ( https://www.w3schools.com/css/ ). |
|
HyperlinkRegexPattern |
Regular expression |
Allows the use of a regular expression to detect a hyperlink in the e-mail's content and add it as a separate link in the WebAgent. |
|
IncomingProcessingStatus |
New or Preprocess |
New |
Set the processing status of a new e-mail. Preprocess can be used with another service to add the message to CRM Customer Relationship Management, or CRM, is (usually) a software-based, data management method to deal with interactions with customers and potential customers. for example. |
ReadCategorizedOnly |
True or False |
False |
Whether or not to only read e-mails that have a category ( https://www.windowscentral.com/how-use-microsoft-outlook-categories-labels ). Categories are seen as Tags and these can be used for e-mail routing using the PluginFlowSettings list. |
MaxSubjectLength |
Whole number greater than or equal to 78 and smaller than or equal to 240 |
78 |
Maximum length of an e-mail subject. Some clients can handle only a maximum number of characters. |
ReferencePrefix |
Text |
A365 |
A prefix to the reference to identify the e-mail as part of a conversation. It's recommended to use the initials of the company. |
ReferenceFormat |
Text which must have the placeholder {0} |
[{0}] |
The format of the reference as it will be added in the subject of an e-mail, e.g. My Subject [A365-00001-76565] |
SubfolderTag |
Text |
Add a tag to each new e-mail which can be used for routing e-mails using the PluginFlowSettings list. |
|
InboxSubfolder |
Text |
Have the provider use a subfolder of the Inbox folder. You can go deeper by adding this setting multiple times with a number suffix, e.g. InboxSubfolder2 |
|
AddMessageThreadToReply |
True or False |
False |
When set to True the "bodyPreview" (content of the previous messages) are added below the reponse. When set to False the "bodyPreview" is overwritten with the response. |
AddMessageThreadToForward |
True or False |
False |
When set to True the "bodyPreview" (content of the previous messages, this also include attachements) are added below the forward. When set to False the "bodyPreview" is overwritten with the response. |
OutboundTextSkill |
Name of the outbound skill (default is empty) For example: OUTBOUNDTextSkill Note The Skill needs to be created in the UCC A Unified Contact Center, or UCC, is a queue of interactions (voice, email, IM, etc.) that are handled by Agents. Each UCC has its own settings, IVR menus and Agents. Agents can belong to one or several UCCs and can have multiple skills (competencies). A UCC can be visualized as a contact center “micro service”. Customers can utilize one UCC (e.g. a global helpdesk), a few UCC’s (e.g. for each department or regional office) or hundreds of UCC’s (e.g. for each bed at a hospital). They are interconnected and can all be managed from one central location.. |
WebAgentService |
Used for enabling the Outbound Text Session. This Skill is also used for Reporting purposes. |
Exchange Web Service Only
Warning
EWS is no longer supported by Microsoft, for more information see: Exchange Online – September 2022 Update
Setting | Value | Default | Description |
---|---|---|---|
Uri |
Uri to the Exchange mailbox, e.g. https://outlook.office365.com/EWS/Exchange.asmx for Office365 Outlook |
||
Username |
Username to connect to the mailbox. |
||
Password |
Password to connect to the mailbox. |
||
EncryptedPassword |
Password to connect to the mailbox, encrypted using the A365.PWTool |
Graph Only
Setting | Value | Default | Description |
---|---|---|---|
Tenant |
Directory/Tenant ID or directory as text |
Microsoft Entra tenant. |
|
ClientId |
Client/Application ID |
||
ClientSecret |
Generated client secret |
The client secret. |
|
EncryptedClientSecret |
ClientSecret encrypted using the A365.PWTool. |