Skip to main content

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

Migrating from Legacy Webchat to Web Messaging

Updated on August 2, 2023

Switch to the Digital Messaging interface from your existing Legacy Webchat interface if you want to use the new React-based Web Messaging widget.

Before you begin: Learn about the Legacy Webchat to Web Messaging best practices. For more information, see Legacy Webchat to Web Messaging migration best practices.
  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.
    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 interface.
  4. In the Copy channel pop-up window, click Bot Agent to switch from your Legacy Webchat to the Digital Messaging interface.
    For example:

    The following figure shows how to copy a channel 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.
    Result: 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.
  • Previous topic Troubleshooting checklist for the Legacy Webchat to Web Messaging migration
  • Next topic Setting up the IVA for Web Messaging

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