Skip to main content


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

Configuring listener accounts for emails and appointments

Updated on December 21, 2020

With Pega Sales Automation, you can push emails and appointments from Microsoft Outlook (or another default mail client) to the Pega Platform. When an email or appointment is received, an email listener account identifies the recipients and maps the email or appointment to the appropriate operator.

You can associate incoming emails and appointments with contacts, organizations, and accounts in the application, and you can use Microsoft Outlook's vCard functionality to create a Pega Sales Automation contact from an Outlook contact.

Follow these steps to configure listener accounts for emails and appointments:

Creating the access group, operator, and email accounts

To set up your listener account, you must create an access group and an operator ID, and configure email accounts to accept incoming emails and send bounce-back notifications.

  1. In Dev Studio, create an access group. The default access group is PegaCRM-SFA:Services with the following attributes:
    • PegaRULES:User4 role
    • Open, modify, search, and execute activity access to PegaCRM-Document-Email
    If you do not use the default access group, you must change the Service access group on the FWEmailCollector service class. For more information, see Access groups.
  2. Create an operator role with the newly created access group. Enter this operator in the Requestor Login section for the email listener. For information, see Operators.
  3. Configure the SyncEmailCalendar email account.
    This is the account that the email listener uses to import emails and appointments. You can link this account to any email address. For more information, see About Email Account data instances.
    Note: For Exchange integration, enter your Exchange server information when you configure the SyncEmailCalendar email account.
  4. Configure the SyncEmailCalendar email listener.
  5. Create or modify the default email account with the type Notify. Pega Sales Automation uses this account to send a bounce-back email if the incoming message cannot be associated with any object in the application. Configure the Notify email account to look like it is an official communication coming from the application.

Creating new email and appointment classes in the implementation layer

You must create new email and appointment classes in your implementation layer for the integration to work properly.

  1. In Dev Studio, create new classes for emails and appointments:
    1. Set the direct inheritance for the email class to PegaCRM-Document-Email.
    2. Set the direct inheritance for the appointment class to PegaCRM-Work-Appointment.
    For more information, see Class layers.
  2. Update the PegaCRM-Document-Email.getAppointmentClass decision table to default to your new appointment class.
  3. Create a new service package using the FWEmailCollector service as a guide.
  4. Update the service email rule to set the page class to your new email class.

Configuring associations with other application objects

You can associate emails and appointments with other objects in the application, such as organizations, accounts, and contacts. Because your implementation uses classes inheriting from Pega Sales Automation classes, you need to be sure that the email integration is associating emails and appointments with implementation layer objects.

For Emails, this association is configured through activities called from PegaCRM-Embed-Recipient.lookupRecipient. For appointments, this association is configured through activities called from PegaCRM-Embed-Recipient.DoRecipientAssociations.
  1. To update contact associations, in Dev Studio, perform the following steps:
    1. Override @baseclass.crmFindContactByEmail.
    2. Replace references to the PegaCRM-Entity-Contact class in the obj-browse calls, pages, and classes to refer to your contact implementation class.
  2. To update organization associations, perform the following steps:
    1. Create an implementation class for PegaCRM-Index-OrgDomains.
    2. Update the class references in @baseclass.crmFindOrgByDomain.

Updating the user interface

Emails and appointments appear in several places in the Pega Sales Automation user interface. You must update application rules to change class references to your implementation classes.

  1. In Dev Studio, update the following rules for appointments:
    1. Data-Portal.SFAPortal_MyCalendar - Modify the configuration of the pxCalendar control to update the class reference on the Appointments tab.
    2. @baseclass.crmPopulateAppointmentEvents - Modify step 1 to update the report class.
    3. crmRelatedAppointments - Override this rule in your implementation class to update the class reference to the report definition. Update both the repeating grid and the Open Report icon. There are versions in PegaCRM-Entity-Contact and PegaCRM-Entity-Org.
  2. Copy the following report definitions from PegaCRM-Work-Appointment to your implementation class:
    • crmAppointmentsByContact
    • crmAppointmentsByOperator
    • crmAppointmentsByOrg
  3. Update the following rules for emails:
    • crmRelatedEmails - Override this rule in your implementation classes to update the class reference to the report definition. Update both the repeating grid and the Open Report icon. There are versions in PegaCRM-, PegaCRM-Entity-Contact, and PegaCRM-Entity-Org.
  4. Copy the following report definitions from PegaCRM-Document-Email to your implementation class:
    • crmEmailsByLinkedID
    • crmEmailsByOperatorID
    • crmEmailsByContact

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.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us