Skip to main content

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

Customizing the Legacy Webchat channel

Updated on July 4, 2023

Modify the styling of Pega Intelligent Virtual Assistant™ (IVA) for Legacy Webchat to fit your business needs and requirements. You can customize the Cascading Style Sheets (CSS) styles, change the text for the action prompt for the chatbot, customize a user interface section used for chat responses, and also add custom controls to the channel.

Note: Pegasystems will sunset the Legacy Webchat servers on October 31, 2023. Legacy Webchat has been replaced with the Web Messaging channel from Digital Messaging. Legacy Webchat was deprecated in 8.6 and de-supported in 8.7. Legacy Webchat is not supported for 8.7 and has not been tested. To learn how to migrate to Web Messaging, see Migrating from Legacy Webchat to Web Messaging.
Before you begin: Embed a chat window on a webpage for a Legacy Webchat channel. For more information, see Embedding a chat window for the Legacy Webchat channel.

For example, add your own icons or additional useful information, such as date and time stamp for each chat message.

Note: The styling changes that you make in the system affect all Legacy Webchat channels that are defined in a Pega Platform application.
  1. Switch to Dev Studio.
  2. In the header of Dev Studio, click the name of the application, and then click Channels and interfaces.
  3. In the Current channel interfaces section, click the icon that represents your existing Legacy Webchat channel.
  4. Modify the default text for the action prompt that is displayed in the preview console and chat window for the IVA.
  5. Update the Legacy Webchat channel section used for user input.
    1. Edit the pyRenderSimulatorInbound section.
    2. Make user interface changes in the section.
    3. Click Save.
  6. Update the Legacy Webchat channel section used for the response.
    1. Edit the pyRenderSimulatorOutbound section.
    2. Make user interface changes in the section.
    3. Click Save.
  7. Change the CSS styles for the Legacy Webchat channel.
    1. Edit the pyWebChatCustomization rule.
    2. Modify the CSS styles, for example, for the background color, client input, submit area, header text, or submit button.
    3. Click Save.
  8. Create custom controls in the Legacy Webchat channel.
  9. Switch back to App Studio.
  • Previous topic Embedding a chat window for the Legacy Webchat channel
  • Next topic Changing the default text for action prompt in the IVA for Legacy Webchat

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. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us