The Email Agents allow you to read and send emails in your data streams. You can use this to integrate business processes into email communications. They support Basic (username and password) and OAuth (token-based authentication via OAuth 2.0) authentication to connect to the email server.
The Listener can read emails from a POP3 or IMAP server. This is useful for automating business responses to email notifications.
The Action Agent allows you to send emails. You can use this to send email notifications when things happen or automate responses to incoming emails based on the status of your stream.
The Download (Action Agent) allows you to download emails as an eml file from the IMAP server with the provided Message-IDs in the Inbox folder. It can be used for exception handling in conjunction with the Listener - email content that can't be processed could be forwarded for manual processing.
Microsoft will no longer support basic authentication for Exchange Online on the IMAP and POP3 protocols after December 2022. Please be advised to upgrade your Email Agents and adjust their configuration to use OAuth authentication. For more information on the deprecation and migration, visit their documentation.
Pre-requisites
None at this time
Current Version
Request the Email Listener v3.25
Request the Email Action Agent v4.29
Request the Email Download Action Agent v1.06
Please contact XMPro if you're looking for an older version of this Agent.
Email Listener Release Notes
2022
v3.25, 23 Dec 2022
Added Email Client Token Interval property to cache and refresh email token for OAuth authentication
v3.24, 23 Nov 2022
Added support for OAuth authentication
Repackaged to include Agent's category
v3.22, 02 Feb 2022
Output Attachment File content as base64 binary string
2021
v3.14, 29 Nov 2021
Added IMAP Protocol
v1.32, 28 Jan 2021
Added variables for email host and port
v1.31, 12 Jan 2021
Made sure properties open up, variables are added in and sensitive information isn't passed through to the next agent
v1.28, 12 Jan 2021
Formatted username to be plain string instead of string array
v1.26, 18 Dec 2020
Added "To" email address as username in output
2019
v1.24, 04 Mar 2019
Added variable support
v1.12, 4 Mar 2019
Updated help url
2018
v1.11, 13 Aug 2018
Added validation
Added error endpoint
v1.1, 18 Jun 2018
Initial release
Email Action Agent Release Notes
v4.29, 28 Mar 2024
Added support for CC and BCC
Added variable support for the From address (Get From Email Address property)
2023
v4.27, 01 Dec 2023
Added error handling for connection timeout
v4.26, 25 May 2023
Added the Refresh Place Holder button to make it easier to add a placeholder to the message
Changed the From property from multiple input (Tagbox) to single input (Dropdown) - with backward compatibility support
2022
v4.25, 23 Dec 2022
Added Email Client Token Interval property to cache and refresh email token for OAuth authentication
v4.24, 23 Nov 2022
Added support for OAuth authentication
v4.23, 12 Feb 2022
Fix agent error when agent is unpublished
2021
v4.21, 05 Apr 2021
Removed re-try option as the email send error could happen for different reasons
v4.20, 19 Jan 2021
Handle multiple email addresses (separated by semi-colon or comma) in the mapped input field
2020
v4.1, 13 Aug 2020
Added Html template functionality
v4.01, 06 Aug 2020
Fixed issue with system variables
v4.0, 13 May 2020
Added variable functionality
v3.2, 13 Aug 2020
Added Html template functionality
v3.12, 09 Apr 2020
Removed postback from Body control to avoid postback on every keystroke
v3.10, 23 Jan 2020
Added validation
2019
3.09, 12 Sep 2019
Fixed issue with reconnecting to SMTP server on disconnect or error
3.07, 06 Sep 2019
Sending emails asynchronously in a separate thread
v3.05, 05 Sep 2019
Replaced System.Net.Mail package with MailKit
v3.04, 27 Aug 2019
Moved code from Start method to Create
Changed token field separator from semicolon to comma
Enabled custom tokens in From and To fields
v3.02, 4 Mar 2019
Updated help url
2018
v3.01, 13 Aug 2018
Added error endpoint
v3.0, 20 Apr 2018
Initial release
Email Download Action Agent Release Notes
2022
v1.06, 23 Dec 2022
Added Email Client Token Interval property to cache and refresh email token for OAuth authentication
v1.05, 23 Nov 2022
Fixed issue when multiple emails are fetched for a given message id
Added support for OAuth authentication
Category changed from Function to Action Agent
v1.04, 28 Mar 2022
Initial Release
Last updated