Skip to main content


Embedding a chat window for the Legacy Webchat channel

Suggest edit Updated on September 7, 2021

Generate mashup code for your Legacy Webchat channel and embed it on an external website like a web page. The web page displays a chat window where users can interact with a Pega Platform application, for example, to obtain a list of commands or open a case.

Before you begin: Create a Legacy Webchat channel and obtain access to a web page for which you will embed the mashup code for a Legacy Webchat channel. For more information, see Creating a Legacy Webchat channel.

To generate the mashup code for a website, specify a URL address for your Pega Platform application so that the system knows where to connect during a chat conversation.

Note: Generate the mashup code again and embed it on a web site, if you change any Legacy Webchat channel settings, for example, the URL for your Pega Platform application.
Design Patterns: To learn about configuring authentication for the IVA for Legacy Webchat, see Authentication in Web Chatbot.
  1. In the navigation pane of App Studio, click Channels.
  2. In the Current channel interfaces section, click the icon that represents your existing Legacy Webchat channel.
  3. In the Legacy Webchat channel interface, click the Mashup tab.
  4. In the Mashup URL field, enter the URL for your Pega Platform application. For example:
  5. Click Save, and then click Generate.
  6. Copy and save the generated code from the Mashup code text area, for example, click Copy to clipboard.
  7. Embed the mashup code from step 6 on a web page that will be used as an IVA for Legacy Webchat.
What to do next: Style the IVA for Legacy Webchat to fit the needs and requirements of your organization. For more information, see Customizing the Legacy Webchat channel.
Did you find this content helpful? YesNo

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

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