Skip to main content


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

Troubleshooting and diagnostics

Updated on January 20, 2022

The Pega Knowledge “troubleshooter” provides diagnostics capabilities allowing customer product or service issues to be diagnosed and resolved using dynamic, rich text questions that guide the end user through a series of steps to help resolve issues. The troubleshooter supports linking related articles with questions, and the ability to insert images or videos to provide a more visual diagnostic experience. Suggested actions can be configured to allow an end user to launch a service request from the related Pega Customer Service application through Pega Web Mashup.

Pega Knowledge Product Overview Product Overview

Knowledge authors create troubleshooters from the Troubleshooters navigation link in the authoring portal and can quickly start creating the diagnostic questions and actions through an intuitive configuration tool. Authors manage their draft and published troubleshooters in different tabs to ensure separation of completed (published) and draft troubleshooters. While creating questions, the author will also see a list of the questions they have already added to their troubleshooter for quick visual reference. A question repository allows authors to reuse questions in multiple troubleshooters, avoiding duplication of common questions. Questions in troubleshooters can also be reordered when a new question needs to be added or other resequencing of questions is required. Authors also have a graphical view option that displays the troubleshooter in a tree format, providing a “big picture” view of the full troubleshooter tree and branches.

The rich text editor supports a wide variety of question formatting, as well as options for inserting relevant images and videos to provide a visually-engaging end user experience. Launching a Customer Service case is also supported, which allows a customer to seek additional help if they cannot self-diagnose their issue, so that customers are not stranded. The troubleshooter also supports launching other troubleshooters to create multi-branched complex diagnostics. Once a troubleshooter has been configured, the troubleshooter can be run in the Pega Customer Service interaction portal as a case, or in a web self-service portal as a Pega Web Mashup case.

A Pega Customer Service Guided Troubleshooter service case enables CSRs to help customers diagnose issues. A “Troubleshooter categories” configuration in the knowledge portal allows organizations to define the relevant Products, Problem type, Sub-problem type, and corresponding troubleshooter to launch. This provides CSRs with a simple navigation path to the appropriate troubleshooter as they work with their customers.

Troubleshooters that are abandoned by customers during a self-service interaction are automatically suggested in the Pega Customer Service Next Best Action area for immediate visibility to CSRs. CSRs can continue in the step where the customer left the troubleshooter, or they can start again. When they open the Guided Troubleshooter service case, CSRs also have visibility into what questions and answers a customer has already completed. The troubleshooter service request can also be exposed to web self-service applications using Pega Web Mashup. The key troubleshooter features are described next.

Guided Troubleshooting service case

Once configured in the Pega Knowledge authoring portal, troubleshooters are available to Pega Customer Service users as service cases and can help guide customers through diagnostics steps through common contact center channels. The troubleshooter case can also be exposed in your web self-service applications using Pega Mashup, which empowers customers to self-diagnose and resolve issues, and can help to increase call deflection rates.

Reuse questions

Authors can reuse common questions in multiple troubleshooters by flagging a question for the ‘Question repository’. This eliminates the need to recreate common questions like “Did this resolve your issue?”

Reorder questions

When authors need to add a new question in the middle of a troubleshooter, the configuration tool allows the author to easily drag and drop the new question where they want. Validation rules warn an author if any question visibility conditions are violated.

Response types

Specify question response types from a simple dropdown including Radio buttons, Auto-complete, Textbox, Answer/Information, Launch another troubleshooter, or Specify a Link.

Configure troubleshooter categories

Authors can configure the hierarchically-related Product, Problem type, Sub-Problem type, as well as the corresponding troubleshooter that provides CSRs and end users with an easy navigation path to selecting the appropriate troubleshooter.

Graphical view of troubleshooters

Authors can view a troubleshooter design in a tree view display to see the various branches of the questions and their response type options.

Restart a troubleshooter

End users can restart a troubleshooter if they need to. This can be helpful if they change their mind about an answer on a previous question. In addition to restarting from the beginning, navigation options make it possible to simply navigate back to the previous question.

Suggested actions

Authors can specify Pega Customer Service case (service requests) that provide end users with other options, such as to escalate an issue, or to schedule an appointment with a technician.

Add a service

Configure a service call to an external API for remote diagnostics or other external function to help diagnose or perform a remote action on a customer’s device.

Related articles and attachments

Authors can also specify related knowledge articles to provide additional details about a diagnostic topic or a specific question, as well as file attachments, which can help when a diagram or user manual may help with the diagnostic process.

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