Skip to main content
This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Table of Contents

Configuring the push mechanism for Microsoft Exchange to Pega Sales Automation 8.1 and later calendar integration

Microsoft Exchange to Pega Sales Automation calendar integration is a background process that synchronizes your Microsoft Exchange calendar with your Pega Sales Automation calendar. The push mechanism for calendar integration listens for Exchange Web Services (EWS) notifications to identify new, updated, and canceled appointments on the Microsoft Exchange server, then synchronizes the appointments with your Pega Sales Automation calendar.

For information about the cloud configuration requirements, see Cloud configuration requirements for Pega Sales Automation calendar synchronization with Microsoft Exchange.

This article applies to versions 8.1 and later. For versions earlier than 8.1, see Configuring the push mechanism for Microsoft Exchange to Pega Sales Automation 7.4 and earlier calendar integration.


Before you can configure the Microsoft Exchange to Pega Sales Automation calendar integration, you must configure and initiate the push mechanism for Microsoft Exchange to Pega Sales Automation calendar integration. For details, see the Pega Sales Automation Implementation Guide on the Pega Sales Automation product page.

Configuring settings for calendar integration

You must configure application settings for your Microsoft Exchange calendar integration.

  1. In the App Studio explorer panel, click Settings > Application Settings.
  2. Click the Microsoft Exchange tab.
  3. In the Exchange Integration section, to enable calendar integration, select the Microsoft Exchange calendar integration check box, then enter the calendar integration settings for your implementation as described in the following table:
    Setting name Setting value
    Exchange URL Enter the URL for your Microsoft Exchange server.
    Exchange version

    Pega Sales Automation supports Microsoft Exchange 2010, 2013, and 2016.

    Enter the Microsoft Exchange version for your implementation in the following format:

    • Exchange2010
    • Exchange2013
    • Exchange2016
    • Exchange365
    Batch size

    Microsoft Exchange supports a batch range of 1 to 512.

    Enter the batch size to tell the application the number of calendar items to process in each batch for a mailbox user. The push agent continues to loop until all calendar items are synchronized.

    Notification URL Enter the end point URL for the PushNotificationsListener REST service for Microsoft Exchange service notifications.
    Notification frequency (min) Enter the number of minutes to use as the maximum timeout value before canceling the synchronization and sending a calendar synchronization failure email notification. The application retries the synchronization until the timeout limit is reached. For optimal performance, enter 30 for this setting.
    Notify sync failure to

    Enter the email addresses of the operators to whom you want to send calendar synchronization failure email notifications. Separate email addresses by using a semicolon (;).

    For a description of common calendar synchronization failure messages, see Failure messages for Pega Sales Automation calendar synchronization with Microsoft Exchange.

  1. Click Save.

Configuring the service package for the REST service listener

Modify the service access group in the EWSPushNotifications service package for your implementation.

  1. Log in to Pega Sales Automation as an administrator.
  2. In the Dev Studio header search text field, search for and select the EWSPushNotifications service package.
  3. On the Context tab, enter the Service access group for your implementation.
  4. Click Save.

To avoid locking issues, run the ProcessEWSPushNotifications job scheduler on a single node. To apply custom settings, override the ProcessEWSPushNotifications job scheduler in your implementation layer.

Defining custom settings for the calendar sync job schedulers

  1. Log in to Pega Sales Automation as a system administrator.
  2. In the Dev Studio navigation pane, click Records > SysAdmin > Job Scheduler.
  3. Search for and open the ProcessEWSPushNotifications job scheduler.
  4. Click Save as and save it to your implementation layer.
  5. On the Definition tab, modify the Schedule section based on your business requirements.

For real-time sync, make sure to keep the schedule in minutes.

  1. In the Context field, select either Use System Runtime Context or add your access group by selecting Specify access group.
  2. Click Save.

Starting the calendar synchronization push agents

When you start the calendar synchronization push agents for the first time, Pega Sales Automation begins to synchronize all future appointments for the operators that are enabled for calendar synchronization. During the initial synchronization, the push agents also synchronize past appointments for the operators within a specified time period. The time period that is used for synchronizing past appointments is driven by the IsSkipAppointment when rule. The default value for this rule is 180 days.

After the initial synchronization completes, the push agents only synchronize future appointments that have been created, updated, or deleted since the last synchronization.

  1. Log in to Pega Sales Automation as a system administrator.
  2. Open Admin Studio.
  3. In the Admin Studio navigation pane, click Resources > Jobs.
  4. Search for the ProcessEWSPushNotifications job scheduler.
  5. Click Override to enable it.

Enabling operators for calendar synchronization

You must enable calendar synchronization for each operator who will use the feature.

  • You can enable calendar synchronization in bulk for existing operators by using the Pega Sales Automation Data Import wizard to update your operator records in Pega Sales Automation.
  • You can enable calendar synchronization for a new operator when you create the operator record in Pega Sales Automation.

To verify that calendar synchronization is enabled for an operator, complete the following steps:

  1. Log in to Pega Sales Automation as a system administrator.
  2. In Dev Studio, click Launch web interface > Sales Ops.
  3. In the navigation pane, click Operators.
  4. Open the operator record.
  5. Verify that the Calendar Sync option is set to True.
  6. Verify that the email address in the Email field is the operator's Microsoft Exchange email address.
  7. To change the operator's calendar synchronization access or email address, click Actions > Update Operator Profile.
Suggest Edit
Did you find this content helpful?

Related Content

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us