Pega Customer Relationship Management suite of applications
Pega Customer Service, Pega Sales Automation, and Pega Customer Decision Hub are components of the Pega Customer Relationship Management suite of applications. Client implementations using these components build an implementation layer on top of these applications, which are built on Pega Platform.
Apart from the core functionality of the individual components, the following Pega Customer Relationship Management shared features are available:- Shared case types. For example, Pega Sales Automation operators can process Pega Customer Service cases, and Pega Customer Service operators can create and update Pega Sales Automation leads and opportunities, and can schedule appointments.
- Shared customer history across applications, including: recent leads, opportunities, sales activities, marketing engagements, service cases, and interactions.
- Shared customer events across applications, displayed in the Customer journey or Customer movie widget in the customer composite of the Pega Customer Service and Pega Sales Automation portals.
- Integration with Pega Customer Decision Hub to enable next-best-action and next-best-offer recommendations and listening across all inbound and outbound channels.
- Local campaigns. Create local campaigns from a Pega Sales Automation system by using Pega Sales Automation contacts as the system of record. Based on the customer responses, services exposed in Pega Sales Automation create and update marketing activity and leads in Pega Sales Automation.
- Next Best sales activities. Intelligence to identify the top sales activities that a sales representative can perform to work an account.
For information about how to implement the Pega Customer Relationship Management suite of applications, see "Optional: Configuring your applications to support CRM," next.
Optional: Configuring your Pega applications to support CRM
These procedures are required only if you will use the Pega Customer Relationship Management suite of applications to share data and service cases across the Pega Customer Service, Pega Sales Automation, and Pega Customer Decision Hub applications.
These procedures involve configuration across multiple applications, and therefore include links to multiple application implementation guides.
If you have installed industry-specific applications on top of Pega Customer Service and Pega Sales Automation, complete these configuration steps in the industry applications, and not in the base Pega Customer Service or Pega Sales Automation applications.
To configure your Pega applications to support shared features, complete the following steps:
- For environments that include both Pega Customer Service and Pega Sales Automation, complete the following steps:
- Add the Pega Sales Automation implementation rulesets to your Pega Customer Service application, and add the Pega Customer Service implementation rulesets to your Pega Sales Automation application. See "Adding shared rulesets," next.
- Create an integration ruleset for your Pega Customer Service and Pega Sales Automation applications, and then add the integration ruleset to the top of the ruleset stack for each application. See "Creating integration rulesets," later in this section.
- Enable the Pega Customer Relationship Management features. See "Enabling shared features," later in this section.
- In your Pega Customer Service application, update the operator access groups to include the CustomerService:CSRSalesAccess role that is required to access the shared features. See "Updating an access group to allow shared access," later in this section.
- For environments that also include Pega Customer Decision Hub, complete these additional
steps.
- Configure your Pega Customer Decision Hub application as described in Configuring your application to the Customer Relationship Management suite in the Pega Customer Decision Hub Implementation Guide on the Pega Customer Decision Hub product page.
- Configure your Pega Customer Service application to support Pega Customer Decision Hub.
- Enable Pega Customer Decision Hub. See Configuring application settings.
- Configure Customer Decision Hub settings. For each setting, copy the rule to the highest ruleset shared by Pega Customer Service and Pega Sales Automation, and save your changes in that ruleset. See Configuring Customer Decision Hub.
- In Pega Customer Decision Hub, configure the application to support the Pega Customer Relationship Management features. See "Configuring Pega Customer Decision Hub to support the Pega Customer Relationship Management features" in the Pega Customer Decision Hub Implementation Guide on the Pega Customer Decision Hub product page.
- In your Pega Sales Automation application, configure the integration between Pega Sales Automation and Pega Customer Decision Hub. See "Configuring the integration between Pega Sales Automation and Pega Customer Decision Hub" in the Pega Sales Automation Implementation Guide on the Pega Sales Automation product page.
- In your Pega Sales Automation application, test the integration with Pega Customer Decision Hub local campaigns. See "Testing the Pega Sales Automation integration with Pega Customer Decision Hub local campaigns" in the Pega Sales Automation Implementation Guide on the Pega Sales Automation product page.
- In Pega Customer Decision Hub, train the adaptive model for sales offers. See "Configuring Adaptive Decision Manager for sales offers" in the Pega Customer Decision Hub Implementation Guide on the Pega Customer Decision Hub product page.
- In your Pega Sales Automation application, test the integration with Pega Customer Decision Hub next best offers. See "Testing the Pega Sales Automation integration with Pega Customer Decision Hub next best offers" in the Pega Sales Automation Implementation Guide on the Pega Sales Automation product page.
Creating integration rulesets
When using a Pega Customer Relationship Management configuration that includes both Pega Customer Service and Pega Sales Automation, you must sometimes override the rules in one application to expose functionality from the other application. To support this, create an integration ruleset in both applications, and then save the override rules to the integration ruleset.
For example, if the Pega Customer Service application will show Pega Sales Automation Lead case service cases, you want the service case header and footer to look the same as the other Pega Customer Service services cases. In that case, save the perform harness rule for the service case into the integration ruleset for the Pega Customer Service application. Doing so overrides the Pega Sales Automation header and footer for that service case.
This procedure is required only if you are sharing data and service requests between two or more applications in the Pega Customer Relationship Management suite.
The applications include a sample integration ruleset that you can copy or use as a model for a new integration ruleset. The sample integration ruleset for Pega Customer Service is SAforCS, and the sample integration ruleset for Pega Sales Automation is CSforSA.
Complete the following steps to configure the integration rulesets:
- Log in to your Pega Customer Service application in Dev Studio.
- Click .
- In the Application rulesets section, click Add ruleset.
- Type a name for the new integration ruleset that identifies its purpose. For example, MyApp CRMIntegration, where MyApp is your application prefix.
- Click the Open icon to the right of the ruleset field.
- Review the default Ruleset Name, Version, and Description values, and modify the values if needed.
- Click Create and Open, and then click Save.
- In the ruleset field, identify which version of the ruleset to use by appending the major and minor rule version to the end of the integration ruleset name in this format: :NN-NN. For example, to select the first version of the ruleset, append :01-01 to the end of the ruleset name.
- Move the new integration ruleset to the top of the ruleset stack by dragging the number to the left of the ruleset name to the top of the stack.
- Click Save.
- Repeat this procedure for your Pega Sales Automation application.
Enabling shared features
To share data and service cases across the Pega Customer Service and Pega Sales Automation, enable the shared features. For more information about the shared features, see Pega Customer Relationship Management suite of applications.
- Open your Pega Customer Service application.
- In the navigation pane of App Studio, click .
- In the list of general settings, click Sales Automation.
- To enable your application to use the pre-integrated Pega Sales Automation features, select the Enable Sales Automation check box.
- Click Save.
- Open your Pega Sales Automation application.
- In the navigation pane of App Studio, click .
- Select the Enable CRM mode check box.
- Click Save.
Configuring the integration between Pega Sales Automation and Pega Customer Decision Hub
The Pega Customer Relationship Management suite includes sample marketing artifacts that you can import to demonstrate the next-best-offer and local campaigns features in Pega Sales Automation.
For more information about the next-best-action and local campaigns features, see Implementing Pega Customer Decision Hub features.
- In the header of Dev Studio, click .
- Open the NBAA system record and configure it the following
way:
- On the Environment tab, select the Connect using mashup connection type.
- In the System URL field, enter the URL of your Pega Customer Decision Hub.
- In the Application Name field, enter the name of your Pega Customer Decision Hub application at the implementation layer.
- Update the SFAUserProfile the following way:
- In the User name field, enter the system admin user ID and password.
- In the Host name enter the host name of the Pega Sales Automation application instance.
- Open the PEGANBAM:Agents rule and ensure that it points to your Pega Customer Decision Hub application.
- Add the CRMFSSample:MarketAnalysts access group to the sales representative operator.
- In the header of Dev Studio, click and ensure that the NBA service package is updated to remove SSL and uses the Pega Sales Automation access group.
- In App Studio, click and select the Local campaigns check box on the Pega Customer Decision Hub tab.
- Log out of the application and log back in.
Testing the Pega Sales Automation integration with Pega Customer Decision Hub local campaigns
After you complete the steps required to configure the integration between Pega Sales Automation and Pega Customer Decision Hub, verify that you can access the sample marketing artifacts for local campaigns in Pega Sales Automation.
- Log in to Pega Sales Automation by entering the credentials for the Sales Rep persona who has PegaSA:MarketReps as their secondary access group.
- In the header of Dev Studio, click .
- On the navigation menu, click .
-
Verify that you can select the following template offers for the campaign:
- B2CEmailOffer
- B2BEmailOffer
- B2BSMSOffer
- B2CSMSOffer
- Verify that you can add Pega Sales Automation contacts to the campaign.
Testing the Pega Sales Automation integration with Pega Customer Decision Hub next best offers
After you complete the steps required to configure the integration between Pega Sales Automation and Pega Customer Decision Hub, verify that you can access the sample marketing artifacts for next-best-offer opportunities in Pega Sales Automation.
- Log in to Pega Sales Automation by entering the credentials for the Sales Rep persona who has PegaSA:MarketReps as their secondary access group.
- In the header of Dev Studio, click .
- Verify that the Next-best-offer widget displays on the dashboard. With sample data uploaded, the widget shows realistic offers with different rankings for each contact.
- Complete the following steps to test your integration:
- Click a contact to qualify the contact for an opportunity.
- Open a contact to display the top three offers for the contact, ranked highest to lowest.
- Click an offer to qualify the contact for an opportunity to receive the offer.
Sample components included with the Pega Customer Relationship Management suite
The installation media for the Pega Customer Relationship Management suite of applications includes sample applications, a shared application, sample access groups, sample operators, and sample integration rulesets.
The table below lists Pega Customer Service and Pega Sales Automation applications:
Application rule | Usage |
Pega Customer Service | The main Pega Customer Service application that has the SAforCS integration ruleset at the top of the ruleset stack, followed by the Customer Service and Sales Automation rulesets, respectively. The Localization ruleset is the top rule of the ruleset stack. |
PegaCSSample | Pega Customer Service sample application that has the customer relationship management stub rules overridden to support customer relationship management use cases. Contains sample data for demonstration purposes, such as dialogs and data transforms. |
Pega Sales Automation | The main Pega Sales Automation application that has the CSforSA integration ruleset at the top of the ruleset stack, followed by the Sales Automation and Customer Service rulesets, respectively. |
PegaCRMBase is a shared application contains the PegaCRMBase, PegaFW-NewsFeed, and MKT-Integration shared rulesets.
- The PegaCRMBase ruleset contains rules, such as properties, data pages, when rules, and classes, that can be reused by the Pega Customer Service and Pega Sales Automation applications.
- The PegaFW-NewsFeed ruleset contains RSS features that are shared by the Pega Customer Service and Pega Sales Automation applications.
- The MKT-Integration ruleset is an integration ruleset that contains the REST services, data pages, classes, and properties that are used to connect to the Pega Customer Decision Hub application.
In the Pega Customer Relationship Management configuration, applications include the following access groups:
Access Group | Application | Description |
CASysAdmin | PegaCSSample | An admin persona having access to all the portals. |
CACSR | PegaCSSample | A Customer Service representative persona. |
CAManager | PegaCSSample | A Customer Service manager persona. |
CSSalesUser | PegaCSSample | A Pega Sales Automation persona with access to the Account Manager and interaction portals in Pega Customer Service. |
CSRSwitchApp | PegaCSSample | A Pega Customer Service persona with permission to switch between Pega Customer Service and Pega Sales Automation. |
SalesManager | PegaSalesAutomation | A sales manager persona. |
SalesRep | PegaSalesAutomation | A sales representative persona. |
SalesOps | PegaSalesAutomation | A sales ops persona with permissions to set up sales organization operators and territories. |
The table below lists the sample operators included with the sample artifacts:
Login Credentials | Application | Usage |
Mikejones/install | PegaCSSample | A Customer Service representative with access to Pega Sales Automation and the ability to switch between Pega Customer Service and Pega Sales Automation. |
DPercival/install | SFASample | A sales representative with access to Pega Customer Service. |
CSCSR/install | PegaCSSample | A customer service representative. |
CASysadmin/install | PegaCSSample | A customer service admin with access to interaction, account manager, CSR, and back office operations portals. |
CAManager/install | PegaCSSample | A customer service manager with access to the interaction portal. |
Pega Customer Service and Pega Sales Automation include the following integration rulesets to support Pega Customer Relationship Management use cases:
- SAforCS – This ruleset is available in the Pega Customer Service application and contains Pega Sales Automation rules that override Pega Customer Service rules. The override rules include harnesses, data transforms, data pages, and sections that are required to present Pega Sales Automation service cases in the Pega Customer Service portals.
- CSforSA – This ruleset is available in the Pega Sales Automation application and contains Pega Customer Service rules that override Pega Sales Automation rules. The overridden rules include harnesses, data pages, data transforms, and sections that are required to present Pega Customer Service service cases in Pega Sales Automation portals.
For information about how to create a new integration ruleset, see Creating integration rulesets.
Pega Customer Relationship Management suite data model
Pega Customer Service and Pega Sales Automation use their native data models for contact, organization, and other data entities. Because the data models are different in both of these applications, the synchronization of data for contact or organization entities is accomplished by using stub rules.
Applications in the Pega Customer Relationship Management suite use stub rules to synchronize the common attribute values. Each stub rule is overridden in the top-most ruleset to add appropriate logic to perform synchronization of data.
The following table lists the stub rules for Pega Customer Service:
Rule Name | Ruleset | Description |
crmCreateContact | PegaCSSample | Applies to the Work- class. A utility to create contacts. |
crmCreateOrg | PegaCSSample | Applies to the Work- class. A utility to create organizations. |
CRMUpdateContactData | PegaCSSample | Applies to the PegaCA-Work-UpdateContactName class. A utility to update contacts. |
CRMUpdateBUData | PegaCSSample | Applies to the PegaCA-Work-UpdateBusinessDetails class. A utility to update organizations. |
Stub rules from Pega Customer Service contain steps to integrate with Pega Sales Automation. These stub rules are overridden in the Pega Customer Service PegaCSSample sample ruleset. If your Pega Customer Service application reuses the stub rules to update them, then save these rules into the highest ruleset in your application.
The following table lists the stub rules for Pega Sales Automation:
Rule Name | Ruleset | Description |
PegaCRM-Entity- Contact.UpdateExternalContact | CSForSA | Updates the customer service contact when the sales automation contact is updated. |
PegaCRM-Entity- Contact.UpdateCSContact | CSForSA | Updates ExternalContact internally and calls UpdateCSContact.. |
PegaCRM-Entity- Org.UpdateExternalOrg | CSForSA | Updates the business unit in Pega Customer Service when the Pega Sales Automation contact is updated. |
PegaCRM-Entity- Org.UpdateBizUnitInCS | CSForSA | Updates ExternalOrg internally and calls UpdateBizUnitInCS. |
PegaCRM-Entity-Contact.crmEdit_ExternalRequest | PegaCRM-SFA | This activity is called when a customer service flow calls a sales automation edit flow with the isExternalRequest flag set to true. |
PegaCRM-Entity-Org.crmEdit_ExternalRequest | PegaCRM-SFA | This activity is called when a customer service flow calls a sales automation edit flow with the isExternalRequest flag set to true. |
Integration with Pega Customer Decision Hub
The Pega Customer Relationship Management suite includes a PegaCRMMarketingSample.zip file that contains the sample artifacts for demonstrating the integration with Pega Customer Decision Hub. The sample artifacts assume that all applications are installed on a single Pega Platform instance and version, that the applications are maintained separately, and that the integrations between them are handled through Federated Case Management or REST services. In the sample artifacts, to allow Pega Customer Decision Hubto access the contacts in Pega Sales Automation or Pega Customer Service, a database view is built on the crm_entity_contact and pa_contact tables in the NBAM_External schema. The database view is mapped to the Customer class in the Pega Customer Decision Hub application. Flows in Pega Customer Decision Hub use the attributes from the Customer class to locate the targeted segment of customers.
While this architecture can be used for evaluation and demo purposes, for production deployments it is recommended to deploy Pega Customer Decision Hub in a separate Pega cluster and configure data replication jobs to push the data into analytical store. A typical deployment is also is shown in the figure below.
Pega Customer Relationship Management suite relationship table
In the Pega Customer Relationship Management configuration, a cross-reference table is required to match the keys of a contact or organization entity from multiple systems of record to a master contact or organization entity key. Pega Customer Service is the system of record for customer data, and Pega Sales Automation is the system of record for customer and prospect data. It is designed that Pega Sales Automation is the master system of record for customer and prospect data. To match these entity keys from the two different system of records, two cross-reference tables are available in the product – one for contacts and one for business units.
The crm_data_contact_xref contact relationship table has CRMEntityId and ExternalSystem columns. CRMEntityId is the master record key based on the assumption that Pega Sales Automation is the master system of record.
The table below shows the structure of the crm_data_contact_xref contact relationship table with the sample record pattern:
CRMEntityID | ExternalID | ExternalSystem |
PEGACRM-ENTITY-CONTACT CON-123 | CON-890 | CS |
The following table shows the crm_data_org-xref organization relationship table definition with the sample record pattern:
CRMEntityID | ExternalID | ExternalSystem |
PEGACRM-ENTITY-ORG ORG-123 | ORG-890 | CS |
Relationship management tables are mapped to the following data classes:
- The PegaCRM-Data-EntityxRef-Contact data class is mapped to the crm_entity_contact-xref table.
- The PegaCRM-Data-EntityxRef-Org data class is mapped to the crm_entity_org-xref table.
Previous topic Connect to Pega applications Next topic Implementing Pega Customer Decision Hub features