Skip to main content


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

Pega Customer Service procedures

Updated on November 17, 2021

Complete the procedures in this section to adopt features after an update to Pega Customer Service version 8.7.

Pega CRM for Healthcare 8.7 Feature Adoption for Pega Cloud Pega CRM for Healthcare 8.7 Feature Adoption for Pega Cloud Pega CRM for Healthcare 8.7 Feature Adoption for Pega Cloud Pega CRM for Healthcare 8.7 Feature Adoption for Pega Cloud Pega CRM for Healthcare 8.7 Feature Adoption for Pega Cloud Pega CRM for Healthcare 8.7 Feature Adoption for Pega Cloud Pega CRM for Healthcare 8.7 Feature Adoption for Pega Cloud Pega CRM for Healthcare 8.7 Feature Adoption for Pega Cloud Pega CRM for Healthcare 8.7 Feature Adoption for Pega Cloud

Adopting new settings (Pega Customer Service)

Pega Customer Service uses a requestor-scoped Declare_CAApplicationSettings data page to store feature settings that are referenced extensively in the application. The data page is sourced from a series of cascading data transforms that originate in the ApplicationSettings data transform. After an update, it is strongly recommended that you compare data transforms in your implementation application with data transforms in the built-on application to ensure that your implementation application has the latest feature settings.

When a new version of the application is released, the Declare_CAApplicationSettings data page in the built-on application is updated with any new settings, but the copy of the data page in your implementation application does not include the new settings. Missing settings in the implementation application can lead to errors or unexpected behaviors in the application.

Note: If you are using an industry version of Pega Customer Service, run this tool from the industry application, and not from the base application.
Before you begin: Update your built-on application as described in Updating your built-on application.

    Check for missing data transforms

  1. Check whether your implementation application is missing any of the data transforms that contain application settings.
    1. In the header of Dev Studio, search for and open these two data transforms:
      • The ApplicationSettings data transform for your implementation layer.
      • The ApplicationSettings data transform for the locked PegaAppCA class in the built-on application.
    2. Compare the the number of rows in each of the open data transforms.
      Each row in the ApplicationSettings data transform identifies a data transform that contain the settings for the application. If your implementation data transform contains less rows than the PegaAppCA data transform, then copy the missing data transforms to your implementation layer.

      The following figure shows the ApplicationSettings data transform with 19 rows:

      ApplicationSettings data transform
      Update your ApplicationSettings data transform with any missing rows

  2. Copy the missing data transforms to your implementation layer.
    1. In the header of Dev Studio, search for and open the missing data transform, in the PegaAppCA class.
    2. Copy the missing data transform to your implementation layer.
    3. Repeat the above steps for all missing data transforms.
    4. Open the ApplicationSettings data transform for your implementation layer, and add the data transforms that you just copied to your implementation layer.
  3. Check for missing properties

  4. Check whether your existing data transforms are missing any properties.
    1. In the header of Dev Studio, search for and open these two data transforms:
      • The ApplicationSettings data transform for your implementation layer.
      • The ApplicationSettings data transform for the locked PegaAppCA class in the built-on application.
    2. Starting with the first row, click the Open icon to the right of the data transform name to view the data transform.
    3. Repeat the above step for the same row in the data transform for the PegaAppCA class.
    4. Compare the number of rows in each of the open data transforms.
      Each row in the data transform identifies a property that controls a setting for the application. If your implementation data transform contains less rows than the PegaAppCA data transform, then add the missing properties to the data transform that is in your implementation layer.

      The following figure shows the CSExpressSettings data transform with 40 rows:

      Example of settings properties in a data transform
      Shows the properties for the CSExpressSettings data transform

    5. Repeat the above steps for all of the settings data transforms that were present in your ApplicationSettings data transform before the update.

Enabling settings for business conditions (Pega Customer Service)

To ensure that business conditions are created for relevant categories and that they are applied to the suggested cases, enable the settings for the RelevantRecordCategories and EnableBusinessConditionsToConfigureSuggestedCases rules. These settings are disabled by default when you upgrade your application.

For more information about business conditions, see Business conditions.

If you are using an industry application, complete this procedure in the industry implementation application.
  1. In the header of Dev Studio, click ConfigureSystemReleaseToggles.
  2. To ensure that the business conditions are created, follow these steps:
    1. On the Toggle Management page, in the Identifier column, search for RelevantRecordCategories.
    2. In the When rule column, click pzToggle-RelevantRecordCategories.
    3. On the When rule page, ensure that the Is Toggle Enabled using field has a value of PegaRULES and in the drop-down list, you select RelevantRecordCategories.
    4. Click Save.
  3. To ensure that business condition are applied to the suggested cases, follow these steps:
    1. On the Toggle Management page, in the Identifier column, search for EnableBusinessConditionsToConfigureSuggestedCases.
    2. In the When rule column, click Toggle_EnableBusinessConditionsToConfigureSuggestedCases.
    3. On the When rule page, ensure that the Is Toggle Enabled using field has a value of Customer Service and in the drop-down list, you select EnableBusinessConditionsToConfigureSuggestedCases.
    4. Click Save.

Adopting customer search (Pega Customer Service)

Version 8.7 of Pega Customer Service adds enhanced customer search configuration capabilities. This new feature is disabled by default so as not to interfere with existing customer searches. Customers updating from an earlier version of the application can choose to adopt the new customer search feature by enabling the feature. New customers will enable this feature when creating their implementation application.

Note: If using an industry application, complete this procedure in the industry implementation application.

For more information about the new customer search capabilities, see Customer search. For information about the legacy customer search feature, see the version 8.5 Pega Customer Service Implementation Guide.

  1. In the header of Dev Studio, click ConfigureSystemReleaseToggles.
  2. In the Identifier column, locate the NewCustomerSearch toggle, and then click the Edit icon on the right side of the row.
  3. Select the Enable toggle for all option.
  4. Click Submit.
What to do next: Configure the customer search fields, views, and search groups as described in Customer search.

Adopting customer verification (Pega Customer Service)

Version 8.7 adds enhanced customer verification capabilities to the Pega Customer Service applications, and deprecates the little-used legacy verification rules. To adopt this new feature, complete the steps below. For more information about the new capabilities, see Customer verification.

Note: If using an industry application, complete this procedure in the industry implementation application.
  1. Define customer verification settings and questions for different interaction types and service request types.
    For information, see "Configuring customer verification" in Customer verification.
  2. Select the customer verification question category for each interaction case type and service request case type that requires customer verification.
    For information, see "Selecting customer verification questions for an interaction or service case types" in Customer verification.

Adopting customer composites (Pega Customer Service)

Version 8.7 of Pega Customer Service replaces the old customer composite feature with a new version of the feature that you can configure in App Studio. The new version of this feature is disabled by default so as not to interfere with existing composites. After you update your application, you can choose to adopt the new customer composite functionality by enabling the feature. If you are a new customer, the Application Wizard automatically enables this feature when you create your implementation application.

Note:

If you use an industry version of the Pega Customer Service application, complete this procedure in the implementation application that you created for the industry version of your application, and not in the base application.

If you do not enable this feature, the Configure customer composites menu item that is used to configure composite tab content is hidden.

For more information about the new customer composite capabilities, see Customer composite. For information about the legacy customer composites feature, see the 8.5 version of Pega Customer Service Implementation Guide.

  1. In the header of Dev Studio, click ConfigureSystemReleaseToggles.
  2. In the Identifier column, locate the ConfigureComposites toggle, and then click the Edit icon on the right side of the row.
  3. Select the Enable toggle for all option.
  4. Click Submit.
What to do next: Configure the composite tabs and content. For information, see Customer composite.

Migrating from Legacy Webchat to Web Messaging (Pega Customer Service)

Switch to the Pega Customer Service application's Digital Messaging interface from your existing Legacy Webchat interface if you want to use the new React-based Web Messaging widget.

  1. On the Security tab of the application definition in Dev Studio, enter the Manager ID and the Manager Key in the Digital Messaging security section, and then click Save.
    Note: Make sure you are in the application from your stack in which you are setting up your channels.
  2. Navigate to your Legacy Webchat interface.
  3. On the right side of the page, click ActionsCopy channel.
  4. In the Copy channel pop-up window, click Bot Agent to switch from your Legacy Webchat to the Digital Messaging interface.

    Switching from Legacy Webchat to Digital Messaging interface
    Switching from Legacy Webchat to Digital Messaging interface

    Note: Creating a copy of the Legacy Webchat channel using the Bot agent option creates a digital messaging interface with built-in conversation flows, case commands, and responses configured in the Legacy Webchat interface.
  5. On the Channel tab of your new Digital Messaging interface, in the Set up section, enter Template Operator and Base URL (URL for the instance), and then click Save. The system displays the Manage connections button.
    You can now add your connections to the different Digital Messaging channels through the Digital Messaging Manager.
  6. Click Manage connections to access the Digital Messaging Manager.
  7. In the Digital Messaging Manager, create a Web Messaging connection and configure its appearance.
    To display a welcome message to customers when they open the widget for the first time, add the message in the Display Message field on the General tab of Web Messaging connection. The welcome message configured in the Behavior tab of the Digital Messaging interface will not apply.
  8. Deploy the Web Messaging widget on the client’s website pages by copying the code snippet on the Installation tab of your Web Messaging connection and using this snippet to replace the Legacy Webchat Mashup script.

Handling recent cases issue in the General Category service cases (Pega Customer Service for Healthcare)

After you update to 8.6, the Recent tasks section in the Interaction portal might be missing the recent service case work objects for tasks that you added from the General category, which belongs to the PegaCA-Work work pool. In 8.6, the General category service cases were moved to the PegaCPMHC-Work work pool.

To handle the issue when you are updating from previous versions, you need to override the CSServiceCaseSettings data transform rule and save it to the class in your implementation layer that directly inherits from the PegaCPMHC-Admin-ApplicationSettings work class.
  1. In the implementation-layer work class of your Pega Customer Service for Healthcare application, find and record the name of the class that has direct inheritance from the PegaCA-Work class, for example, UplusHealth-CS-Work.
  2. In the header of Dev Studio, enter and search for the CSServiceCaseSettings data transform rule.
  3. Open the rule and save it to your implementation-layer specific application settings class.
    This class should directly inherit from the PegaCPMHC-Admin-ApplicationSettings work class, for example, UplusHealth-CS-Admin-ApplicationSettings.
  4. In the data transform, from the Actions menu, search for the SiteSpecificClassGroupHZ property and update the value to the class name that you recorded in step 1 for example, UplusHealth-CS-Work.
  5. Save the data transform rule.

Updating Pega Customer Service chat capabilities

If you use Pega Customer Service chat and you update from version 8.1 or earlier, update your chat server settings and optionally migrate legacy chat queues.

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