Skip to main content

Email

Connxio lets customers provide messages to the Connxio pipeline by configuring connections to email accounts. We currently support POP3 and IMAP protocols. This page details limitations of email protocols and how to configure and connect to an email account.

Limitations

There are several limitations inherent to the POP3 and IMAP protocols, subsequently we do not recommend sending large volumes through email. Of the two protocols, we recommend using IMAP since this is the newer, more secure and faster choice. Be aware that we do not currently support searching or excluding emails from the pickup, as such all messages arriving in on the email server will be processed according to the configuration.

Configuring the Email adapter​

To configure Connxio to start processing your email messages select the Email option in "Inbound Connection" shape:

Configuring inbound connectionConfiguring inbound connection

On creating a new adapter, a popup with the adapter's input fields will appear. Email has 4 sections; Data Pickup Interval, Core Settings, Advanced Settings and Wrapper.

propertiesproperties

Read more about the properties in each section below:

Data Pickup Interval​

data pickup intervaldata pickup interval
  • Triggering interval: Dictates when files are picked from the Azure Storage account. You can choose between two types; Polling interval and Cron. Find out what's best suited for you here.

Core Settings​

data pickup intervaldata pickup interval
  • Connection String Security Configuration: Reference to the Security Configuration that contains the relevant connection properties.

Advanced settings​

data pickup intervaldata pickup interval
  • Send Attachments: When turned on attachments are treated as separate messages, ie. if a message is delivered to the server with two attachments Connxio will process each attachment as a separate message.
  • Send Message Body: When turned on Connxio will process the message body as a single message through the pipeline.
  • Delete Messages: POP3 will always delete messages as the protocol does not support changing the read property. IMAP will mark messages asa read by default. Turn this property on to make IMAP delete messages.

Wrapper​

data pickup intervaldata pickup interval
  • WrapperType: Choose between Json, XML or None.
  • Might be Wrapped: A wrapper is essentially just a shell around the actual message content that contains information not within the concern of the message itself. Read more about wrappers here.

Retry​

Since Connxio reaches out and picks up files when using the Email inbound adapter, retry is handled by the Connxio framework. If a fault happens when the trigger interval hits, the integration will be marked for execution at the next interval, which is after 60 seconds. This means that even if you have the polling interval/cron set to trigger hourly or event daily, Connxio will try to execute the configuration every minute until it succeeds. This does not happen if the message is already picked up however since Connxio cant be sure the message is possible to requeue on the external message. The message will then be sent to catastrophic retry as described in the Retry Page.