Email

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.

Pre-requisites

None at this time

Current Version

  • Request the Email Listener v3.26

  • Request the Email Action Agent v4.30

  • Request the Email Download Action Agent v1.07

Please contact XMPro if you're looking for an older version of this Agent.

Email Listener Release Notes

Version
Date
Description

3.26

24 Dec 2024

Repackaged to translate the Agent's properties..

3.25

23 Dec 2022

Added Email Client Token Interval property to cache and refresh email token for OAuth authentication.

3.24

23 Nov 2022

Added support for OAuth authentication.

Repackaged to include Agent's category.

3.22

02 Feb 2022

Output Attachment File content as base64 binary string.

3.14

29 Nov 2021

Added IMAP Protocol.

1.32

28 Jan 2021

Added variables for email host and port.

1.31

12 Jan 2021

Made sure properties open up, variables are added in and sensitive information isn't passed through to the next agent.

1.28

12 Jan 2021

Formatted username to be plain string instead of string array.

1.26

18 Dec 2020

Added "To" email address as username in output.

1.24

04 Mar 2019

Support variables.

1.12

04 Mar 2019

Updated help URL.

1.11

13 Aug 2018

Added validation.

Added error endpoint.

1.10

18 Jun 2018

Initial Release.

Email Action Agent Release Notes

Version
Date
Description

4.30

24 Dec 2024

Repackaged to translate the Agent's properties.

4.29

28 Mar 2024

Support CC and BCC.

Support variables for the From address (Get From Email Address property).

4.27

01 Dec 2023

Added error handling for connection timeout.

4.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.

4.25

23 Dec 2022

Added Email Client Token Interval property to cache and refresh email token for OAuth authentication.

4.24

23 Nov 2022

Support OAuth authentication.

4.23

12 Feb 2022

Fix agent error when agent is unpublished.

4.21

05 Apr 2021

Removed re-try option as the email send error could happen for different reasons.

4.20

19 Jan 2021

Handle multiple email addresses (separated by semi-colon or comma) in the mapped input field.

4.10

13 Aug 2020

Added Html template functionality.

4.01

06 Aug 2020

Fixed issue with system variables.

4.00

13 May 2020

Added variable functionality.

3.20

13 Aug 2020

Added Html template functionality.

3.12

09 Apr 2020

Removed postback from Body control to avoid postback on every keystroke.

3.10

23 Jan 2020

Added validation.

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.

3.05

05 Sep 2019

Replaced System.Net.Mail package with MailKit.

3.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.

3.02

04 Mar 2019

Updated help URL.

3.01

13 Aug 2018

Added error endpoint.

3.00

20 Apr 2018

Initial Release.

Email Download Action Agent Release Notes

Version
Date
Description

1.07

24 Dec 2024

Repackaged to translate the Agent's properties..

1.06

23 Dec 2022

Added Email Client Token Interval property to cache and refresh email token for OAuth authentication.

1.05

23 Nov 2022

Fixed issue when multiple emails are fetched for a given message id.

Support OAuth authentication.

Repackaged to change category from Function to Action Agent.

1.04

28 Mar 2022

Initial Release.

Last updated