Synchronizing Microsoft Exchange contacts with Pega Sales Automation contacts
Synchronize your Microsoft Exchange contacts with Pega Sales Automation™ contacts to improve your productivity and eliminate redundancy. Contacts are synchronized by using the push mechanism, which listens for Exchange Web Services (EWS) notifications to identify new or updated contacts on the Microsoft Exchange server and then synchronizes these contacts with Pega Sales Automation contacts.
The following are the feature limitations:
- By default, synchronizing private contacts with Pega Sales Automation is disabled. To synchronize private contacts, use the isSkipContact when condition as an extension.
- Contact categories are required to synchronize Microsoft Outlook contacts with Pega Sales Automation. Adding categories is not available in the Microsoft Outlook Web App. To synchronize contacts, add filters.
- Contact photos are not synchronized with Pega Sales automation.
To configure synchronization between your Microsoft Exchange and Pega Sales Automation contacts, perform the following steps:
- Configure contact integration settings
- Configure the service package for the REST service listener (requires admin privileges)
- Enable job schedulers (requires admin privileges)
- Enable operators for contact synchronization
- Verify contact synchronization for operators
Configuring contact integration settings
You must configure application settings for your Microsoft Exchange contacts integration.
- In the App Studio explorer panel, click Settings > Application Settings.
- Click the tab.
- Optional: In the Microsoft Exchange contact integration check box to enable synchronizing contacts between Microsoft Exchange and Pega Sales Automation.
- In the field, select either 15 or 30 minutes synchronization slot size.
- Review and fill in the following fields:
- In the Exchange URL field, enter the URL for your Microsoft Exchange server.
- In the Exchange version field, enter the Microsoft Exchange version for your implementation in the following format: Exchange2010.
Pega Sales Automation supports only Exchange2010, Exchange2013, and Exchange2016.
- In the Batch size field, enter the number of contact items to process in each batch for mailbox users.
The push agent continues to loop until all contact items are synchronized. Microsoft Exchange supports a batch range of 1 to 512.
- In the Notification URL field, enter the endpoint URL for the PushNotificationsListener REST service for Microsoft Exchange service notifications.
- In the Notification frequency (minutes) field, enter the number of minutes to wait before canceling the synchronization and sending a contact synchronization failure email notification.
The application retries the synchronization until the timeout limit is reached. For optimal performance, enter 30.
- In the Notification synchronization failure to field enter the email addresses of the operators to whom you want to send contact synchronization failure email notifications, separated by a semicolon.
For a description of common contact synchronization failure messages, see Failure messages for Microsoft Exchange to Pega Sales Automation calendar and contacts integration.
section, select the - In the Contact sync check box to enable synchronizing contacts between Microsoft Exchange and Pega Sales Automation.
- Select the synchronization option based on your business requirements.
- Review and fill in the fields from step 3.2 of this procedure together with the following additional field:
- In the Contact Sync Category field, enter the contact group that you want to synchronize.
The default is PegaSASync category. You can enter any contacts group that you have specified in Microsoft Outlook.
- In the Contact Sync Category field, enter the contact group that you want to synchronize.
section, select the - Click .
Configuring the service package for the REST service listener
As an administrator, modify the service access group in the EWSPushNotifications service package for your implementation.
- In the Dev Studio header search field, search for and select the EWSPushNotifications service package.
- On the tab, enter the service access group for your implementation.
- Click .
Enabling job schedulers
As an administrator, enable the ContactSync and ManagePushSubscriptions job schedulers.
- In the Admin Studio explorer panel, click Resources, and then click Jobs.
- Search for the ContactSync job scheduler and click located in the State column to enable it.
- Perform the same steps for the ManagePushSubscriptions job scheduler.
When you start the contact synchronization push job schedulers for the first time, Pega Sales Automation begins to synchronize all past contacts for the operators that are enabled for contact synchronization. After the initial synchronization is complete, the push job scheduler synchronizes the contacts that have been created or updated since the last synchronization.
Enabling operators for contact sync
You must enable contact synchronization for each operator who will use the feature.
- You can enable contact synchronization in bulk for existing operators by using the Pega Sales Automation data import wizard to update your operator records in Pega Sales Automation.
For more inforamtion, see Pega Sales Automation data import.
- You can enable contact synchronization for a new operator when you create the operator record in Pega Sales Automation. On the main Contact sync check box. screen, click and select the
Verifying contact synchronization for operators
To verify that contact synchronization is enabled for an operator, complete the following steps:
- Log in to Pega Sales Automation as a Sales Ops operator.
- In the navigation pane, click Operators.
- Open the operator record that you want to check.
- On the Operator profile, verify that the Contact sync field is set to
true
. - Optional: If contact synch is set to
false
, click Actions > Update operator profile and select the check box. - Verify that the email address in the Email field is the operator's Microsoft Exchange email address.
- Click .
Previous topic Initiating contact synchronization between Microsoft Exchange and Pega Sales Automation Next topic Synchronizing Pega Sales Automation contacts with Microsoft Exchange contacts