Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Configuring email listener processing

Updated on November 23, 2022

Specify how the email listener processes email messages at run time. For example, you can set a limit on the size of the emails that the email listener processes or specify whether the email listener processes autoreply messages, such as out of office notifications or read receipts.

  1. On the Process tab, in the Read Criteria section, define the following criteria:
    1. In the Maximum email size (KB) field, enter a maximum size, in KB, of an email message.
      If you specify a value, the listener does not attempt to process email messages that are larger than this value. A value that you enter in this field overrides the value in the configuration setting prconfig/services/emailMaxSize/default. For more information, see Configuring dynamic system settings.
    2. Specify that the listener processes email messages that are DSN messages by selecting Process delivery status notifications (DSNs).
      When you clear this check box, the listener does not invoke the email service for messages with DSNs. For more information, see the Pega Community article Creating an email service that responds to AutoReply and Delivery Status Notification messages.
  2. In the Data options section, specify how to manage email attachments:
    • If you do not want the listener to process email attachments or to put them on the pyAttachmentPage page, select the No attachments check box.
    • If you want inbound email with inline images to render correctly when the email is processed as HTML, select Embed data for inline images into HTML.

      By enabling this option, both base64-encodes the image as embedded HTML content, and does not attach inline images to the generated HTML message.

    • If you want the listener to save the original email, complete with any attachments or embedded images, as an attachment, select Save original email (in EML format). Use this option when email messages contain embedded images and users need to see them in their original context.
    • Use the Save original email (in EML format) option when email messages contain embedded images and users need to see them in their original context. In such a case, select the No attachments option so the attachments are not saved twice, both individually and as part of the original email attachments.
  3. In the Recovery section, in the Maximum number of recovery attempts field, specify the number of times that the listener attempts to recover email that is being processed during a server failure. By default, the listener attempts a recovery three times.
    • Enter a value for the number of times you want the listener to attempt a recovery.
    • If you do not want the listener to attempt a recovery, enter 0.
  4. Click Save.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us