Creating an email listener

Use email listeners to provide the Pega Platform with the necessary information to route incoming email messages to an email service rule (Rule-Service-Email rule type). Email listeners identify the listener, the email account name, the name of the mail folder to monitor, the message format of the incoming messages, the email service rule to which to route messages, and so on.
Before you begin: Create the email account instance and email service rules.

When an email listener routes a message with file attachements, the listener creates the pyAttachmentPage page (of class Data-ServiceMessage) and puts the files on that page by using the pyAttachNames and pyAttachValues properties. When you configure inbound email, you set up a service activity that is generated to extract files from pyAttachmentPage and attach them to the work item as work item attachments.

The Data-Admin-Connect-EmailListener class contains email listener data instances. They are part of the Integration-Resources category.

  1. In the navigation panel of Dev Studio, click Records.
  2. Expand the Integration-Resources category, and then click Email Listener.
  3. Click Create.
  4. In the Short description field, enter a short description of the listener.
  5. In the Listener name field, specify a name for this listener.
    The name is arbitrary and is only used to distinguish Email Listener instances from one another. Begin the name with a letter, and use only letters, numbers, the ampersand character, and hyphens.
  6. Click Create and open.
What to do next: Configure how your email listener retrieves email messages and specify which service rules it uses for routing. For more information, see Configuring email listener routing.