Add an email trigger
- Updated: 2022/11/04
Add an email trigger
An email trigger runs a Task Bot when an email is received in a particular email account.
If you choose the server type as the Exchange Web Services (EWS) using OAuth authentication, the Tenant ID and Client ID fields are mandatory although the interface displays these fields as optional because they can be skipped for Basic Authentication. The recommended practice is to use OAuth authentication for enhanced security.
Procedure
-
Navigate to Tools > Trigger Manager.
The Trigger Manager dialog box appears.
-
Click Add.
The Trigger dialog box appears.
- Specify the Task Bot you want to run in the Select Task field.
- Select Email Message from the Trigger Type list.
-
For IMAP or POP3 email server:
-
Select the IMAP or POP3 option and provide the
following details:
-
Version 11.3.5.7, Version 11.3.1.13, Version 11.3.4.8 or later:
-
Auth Type: Choose from the
following authentication types:
- Basic: Uses the username and password.
-
OAuth2 – Client
credentials: Uses client credentials
flow.
See Authenticate an IMAP, POP or SMTP connection using OAuth
- Host: Host name of the email server.
- Port: Port you want to use to connect to the email server.
- Poll every: Specify the interval in minutes after which time the system checks for new emails on the server.
- User Name: User name you want to use to connect to the email server.
- Client ID and Tenant ID: Enter the unique client and tenant IDs generated when you registered the application in the Microsoft Azure portal.
- Client secret: Enter the client secret that you generated for your app in the app registration portal.
Note:- The email automation created using Version 11.3.5.7 (Basic and OAuth2.0) will not work in the environments where earlier versions of Enterprise 11 (prior to Version 11.3.5.7) clients are used. However, if the bot is not modified in Version 11.3.5.7, it will continue to work in the earlier versions. Any changes to the email command fields will update the internal structure, and the bots will not work in the earlier versions after these changes.
- As a best practice, use credential variables for the client secret, password, and other related fields to avoid storing sensitive information.
The above points also apply to Version 11.3.1.13 and Version 11.3.4.8.
-
Auth Type: Choose from the
following authentication types:
-
Prior to Version 11.3.5.7, Version 11.3.1.13, and Version 11.3.4.8
:
- Host: Host name of the email server.
- Port: Port you want to use to connect to the email server.
- Poll every: Specify the interval in minutes after which time the system checks for new emails on the server.
- User Name: User name you want to use to connect to the email server.
- Password: Password you want to use to connect to the email server.
-
Version 11.3.5.7, Version 11.3.1.13, Version 11.3.4.8 or later:
- Select the Server uses secure connection option if the email account uses secured connection.
-
Select the IMAP or POP3 option and provide the
following details:
-
For Exchange Web Services
(EWS):
-
Select the EWS option and provide the following
details:
- Domain Name: Domain name of the EWS server.
- Poll every: Specify the interval in minutes after which time the system checks for new emails on the server.
- User Name: User name you want to use to connect to the email server.
- Password: Password you want to use to connect to the email server.
- Client ID and Tenant ID: Enter the unique client and tenant IDs generated when you registered the application in the Microsoft Azure portal. These fields are required for OAuth.
- Exchange Version: Select an option from the list to specify the version of the EWS server you want to use.
-
Exchange Url: Specify the
URL of the EWS server.
You can click the Fetch option to populate the Exchange Url field based on the values you have provided in the User Name and Password fields.
-
Select the EWS option and provide the following
details:
- Click Save.