Skip to main content
Version: 4.13.3

Inbound E-mail component

The Inbound E-mail component can be used to retrieve e-mail messages or attachments from an inbox. After retrieving such messages or attachments, they are sent to the next component in the flow.

Configuration​

This component has the following configuration options:

Protocol​

Options

  • imap
  • imaps
  • pop3
  • pop3s
  • smtp
  • smtps

Description

The protocol that is used to connect to the e-mail server.

Host​

Description

The hostname of the e-mail server.

Port​

Description

The port of the e-mail server.

Authentication Type​

Options

  • Basic (default)
  • OAuth

Description

The authentication type used to log in to the e-mail server.

Username​

Description

The username or email address used to log in to the e-mail server.

Remarks

Password​

Description

The password used to log in to the e-mail server.

Remarks

Access Token​

Description

The access token used for authentication on the e-mail server.

The @{<global_variable_name>} expression can be used in this field, for example to insert a dynamically changing access token from the Global variables.

Optionally the #{<environment_variable_name>} expression can be used in this field, for example to insert an access token from the Environment variables that doesn't refresh.

Remarks

Content​

Options

  • Message body
  • Attachments
  • Message body and attachments

Description

Indicates whether message bodies or attachments should be retrieved. When attachments are retrieved and an e-mail doesn't have any attachments then the body will be processed and sent to the next component. A header called noAttachmentsFound with the value true will be added to the exchange so you know when this happens. For example: you can use a simple expression like ${header.noAttachmentsFound} == true in the Content Router component to handle this.

When you selected Message body and attachments both the body and attachments of an e-mail will be processed. The header isEmailBody is added with a value of true when the body is sent to the next component. Another header isEmailAttachment with value of true is added when an attachment is sent to the next component. Every time an attachment is processed the email body is also set on a header called emailBody.

Each attachment is sent as a single message. The original file name of an attachment is stored in the header named CamelFileName.

You can use a Filter to filter in or filter out attachments.

Unseen​

Description

Indicates whether only unread messages should be retrieved.

Remark

This option only applies for the IMAP and IMAPS protocol.

Polling Interval​

Description

The number of milliseconds between each check for new e-mail messages.

Remark

The fewer emails there are present in the mailbox, the faster the reading will be. This applies to both read and unread emails. If you are expecting to 'import' emails big files make sure the polling interval is set to a high enough value.

Search Subject​

Description

An optional string that should occur in the subject of e-mails.

Search Body​

Description

An optional string that should occur in the body of e-mails.

Search From​

Description

An optional pattern describing the recipients of e-mails.

Search to​

Description

An optional pattern describing the sender of e-mails.

Custom SSL Certificates​

It can be the case that the mailbox you are trying to reach uses an SSL Certificate (IMAPS / POP3S), this is not a problem for Dovetail as long as it is signed by a default trusted certificate authority. When the mailbox uses a self-signed certificate, or a certificate not signed by a default trusted certificate authority, the certificate should be retrieved and imported into Dovetail. Unfortunately to date, this has to be done manually by the support staff of Dovetail, please contact your Dovetail provider when necessary.

Remarks​

  • The JavaMail API is used to search for e-mail messages. According to its documentation, the search capabilities depend on the protocol, provider, and server in use. In general, all of the string patterns supported by search terms are just simple strings; no regular expressions are supported.