Skip to main content


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

Defining response commands for a conversational channel

Updated on February 10, 2023

To automate business processes and save the time that case workers spend answering simple questions that are typical of a case type, you can define response commands so that Pega Intelligent Virtual Assistant™ (IVA) correctly reacts to user input. The chatbot detects the best response for a topic, which is the detected subject matter of the conversation, by using text analysis, and then automatically invokes a response type.

For example, when a customer asks for help during an interaction with your chatbot, the system can immediately display a menu of available options as the response command.
Before you begin: Add case commands to the IVA. For more information, see Adding case commands for a conversational channel.

You can also add case commands to the IVA, so that the system automatically starts a case in the application based on user input. All suggested cases and suggested responses that you define are topics.

Note:
  • If your channel does not include a translation for the response command fields, then the system will use the placeholder text specified in the default language for those fields.
  • If you translate text into another language for a response command, the system creates a new language-specific ruleset only if the ruleset does not already exist for the language. If the ruleset already exists and is locked, to translate your text, ensure that you first unlock the ruleset in your application.
  1. In the navigation pane of App Studio, click Channels.
  2. In the Current channel interfaces section, click the icon that represents your existing Digital Messaging channel.
  3. In the channel, click the Configuration tab.
  4. In the Content section, select a method for modifying a response command:
    • To add a new response command, click Add response.
    • To edit an existing response command, click the Switch to edit mode icon for a response displayed in the list.
  5. In the Response type list in the Response configuration window, select and configure a response type:
    ChoicesActions
    Authenticate the user in the system
    1. Select Authenticate.
    2. If you configure multiple languages for the chatbot, select a language for the response text.
    3. In the Response text area, enter the text that you want to display in the selected language.
    4. Optional: To configure additional languages for the response text, repeat steps 5.b through 5.c.
    5. Optional: To add another text to display to the user, below the Response text area, click Add new, and enter additional text.
    Cancel the current work in the interaction session
    1. Select Cancel.
    2. If you configure multiple languages for the chatbot, select a language for the response text.
    3. In the Response text area, enter the text that you want to display in the selected language.
    4. Optional: To configure additional languages for the response text, repeat steps 5.b through 5.c.
    5. Optional: To add another text to display to the user, below the Response text area, click Add new, and enter additional text.
    6. Optional: To add a command to a menu that the system displays after you cancel current work, click Add item.
    7. In the Menu item list, select the command that you want to invoke for the menu item.
    8. In the Label field, enter the menu item name that you want to display in the system.
    9. Optional: To add more commands that you want to display as menu items, repeat the last three steps.
    Display a rich text menu by using a data transform in the IVA for Legacy Webchat
    1. Select Custom.
    2. In the Data transform field, select a data transform rule.
      The rich text menu in the IVA for Legacy Webchat looks similar to a Facebook generic template. The menu consists of a title, subtitle, link to an image, and up to three menu options. You can use the default pyPopulateOutboundData data transform as an example for the IVA.
    Link to a specified Facebook account in the IVA for Facebook
    1. Select Link.
    2. If you configure multiple languages for the chatbot, select a language for the response text.
    3. In the Response text area, enter the text that you want to display to the user in the selected language.
    4. Optional: To configure additional languages for the response text, repeat steps 5.b through 5.c.
    5. Optional: To add another text to display to the user, below the Response text area, click Add new, and enter additional text.
    6. In the Title field, enter a title for the Facebook account to which you want to link.
    7. In the Authentication callback URL field, enter the authentication URL for the Facebook account to which you want to link.
    Display a menu with a list of available commands
    1. Select Menu.
    2. In the Menu template list, select to display the menu items as simple menu buttons or quick replies.
    3. If you configure multiple languages for the chatbot, select a language to define for the response text and menu item labels.
    4. In the Response text area, enter the text that you want to display to the user in the selected language.
    5. Optional: To add another text to display to the user, below the Response text area, click Add new, and enter additional text.
    6. Optional: To add a command to a menu,click Add item.
    7. In the Menu item list, select the command that you want to invoke for the menu item.
    8. In the Label field, enter the menu item name that you want to display in the system in the selected language.
    9. To add more commands to display as a menu item, repeat the last three steps.
    10. Optional: To specify response text and menu item labels in additional languages, repeat steps 5.c, 5.d, and 5.h.
    Restart work on a case that is currently being processed in the session
    1. Select Restart.
    2. If you configure multiple languages for the chatbot, select a language for the response text.
    3. In the Response text area, enter the text that you want to display to the user in the selectd language.
    4. Optional: To configure additional languages for the response text, repeat steps 5.b through 5.c.
    5. Optional: To add another text to display to the user, below the Response text area, click Add new, and enter additional text.
    Display a text message to the user
    1. Select Text.
    2. If you configure multiple languages for the chatbot, select a language for the response text.
    3. In the Response text area, enter the text that you want to display to the user in the selected language.
    4. Optional: To configure additional languages for the response text, repeat steps 5.b through 5.c.
    5. Optional: To add another text to display to the user, below the Response text area, click Add new, and enter additional text.
  6. In the Response command field, enter or modify a user command for the response type.
    Through text analysis, a user command provides the input that determines the best response command type that the system detects.
  7. If the response command requires authentication, select the Requires authentication checkbox.
  8. Click Submit.
  9. Optional: To add or edit more response commands, repeat steps 4 through 8.
  10. Click Save.
For example: The following figure shows the chatbot configuration for a response command that displays a menu with a list of actions related to an insurance quote. If you configure multiple languages for your chatbot, you can also select another language and define the response text and the menu item labels in that language:
The Create command window with a response command definition for an IVA
The Create command window that defines a response command for a menu with a list of commands for an IVA.
What to do next: Configure text analyzers for the IVA. For more information, see Adding a text analyzer for an IVA.

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