This article includes the following topics:
About messaging in the Web SDK
In the new messaging experience, the Web Widget is now called the Web SDK. After enabling messaging, you can configure the Web SDK’s appearance and other settings via Admin Center, then embed Zendesk on your website. Whenever you see Web Widget (Classic) within Admin Center, that’s referring to the existing Web Widget experience that’s live today. If you have multiple brands, you can choose use the SDK with, to try out the new experience with minimal impact on your visitors:
- If a brand has an existing Web Widget, you can convert it to the new Web SDK.
- If a brand is not currently using a Web Widget, you can create a Web SDK from scratch.
The Web SDK is, like the classic widget, a support channel. It's purpose hasn't changed – it's still an embedded way to connect with your customers, just with more streamlined and automated functionality.
Moving from classic Web Widget to the Web SDK
When you enable messaging in the Web SDK for a brand with an existing Web Widget, you're essentially switching off the classic Web Widget and migrating to the new messaging widget. Many of your classic widget configuration settings are automatically migrated to the new Web SDK settings, including:
- Widget position: The widget and launcher will appear wherever you've placed it on your Help Center or web page
- Theme color: The color setting for the launcher, contact button, and header are applied to the Web SDK frame.
- Web Widget button text:During migration, this becomes the Launcher text. As in the Web Widget, it is the text that appears in the launcher button.
- Web Widget snippet: Web SDK and Web Widget (Classic) use the same snippet so there’s no need to update it in order for messaging to work.
- Help Center enablement: If you've enabled the Web Widget in a Help Center, the Web SDK replaces it.
There is some Web Widget functionality that is not available in the Web SDK currently:
- Talk is not enabled in the Web SDK. You can still receive calls through the Agent Workspace.
- Existing Javascript API code is not supported in the messaging beta release. Client-side API support but will be available for GA. However, if you decide to disable messaging, the API code will remain intact and continue to work in the Classic widget. We do recommend that you test any API code not documented as supported by the Web SDK and let us know of any issues.
Creating a new Web SDK
If you want to add the Web SDK to a brand that does not already include an active Web Widget, the process is slightly different. You’ll need to create a Web SDK channel and assign it to the brand before you can customize and configure it, as described below.
To create a new Web SDK
- In Admin Center, click the the Channels icon (
) in the left sidebar.
- Click the Add Channel button, then select Web SDK.
- On the Add Web SDK page, configure each of the sections:
- Set up the basics: Enter a channel name, then use the dropdown to select a brand. Only brands without an existing Web Widget or Web SDK appear in the list.
- Style the appearance: Click the Primary, Message, and Action colors, then enter a hexadecimal number or use the picker to select your colors.
- Install on your site: Choose where to install the Web SDK. See The Installation tab for more information on adding the SDK on your website or Help Center.
- Click Finish. The Edit Web SDK page opens, where you can continue configuring the Web SDK, or leave it as-is.
If you disable messaging for a brand, the Web SDK is converted into the classic Web Widget.
Customizing and configuring the Web SDK
As with the classic Web Widget, the Web SDK includes multiple components that you can customize to best represent your business. Make sure you have enabled the Web SDK before starting the customization process.
To configure the Web SDK
- In Admin Center, click the the Channels icon (
) in the left sidebar.
- Hover your cursor over the brand you want to update, click the options icon (
), then click Edit.
- Click the tab with the components you want to customize. Follow the links below for more detailed information on the options for that tab:
- Basics (channel name and flow)
- Style (Web SDK appearance)
- Preferences (Conversation history settings)
- Installation (Code snippet and Help Center embed)
The Basics tab
The Basics tab includes an editable Channel name field, and a link to the SDK's Flow Builder configuration page.

The Channel name field is automatically populated with the brand name. To make it easier to find in your channels list, you may want to update it to something more unique.
To update the Channel name
- In the Channel name field, delete the text you want to change.
- Enter the new name for the SDK, then click the Save button.
The Style tab
The Style tab includes the appearance-related components of the Web SDK.
In the Frame section, you can update the following:
- Primary color , the main color of the launcher button and SDK header. Enter a hexadecimal number, or click the color swatch to open a color picker. The default color is migrated from the brand's classic Web Widget settings.
- Message color, the color of the bubble around customer messages. Enter a hexadecimal number, or click the color swatch to open a color picker.
- Action color, the color of any buttons or customer actions (such as a selected option). Enter a hexadecimal number, or click the color swatch to open a color picker.
- Logo (optional), a JPG or PNG to appear at the top of the SDK frame. Click Upload image, then browse to the image you want to add.
- Title, text which appears at the top of the SDK frame – usually a call to action ("Contact us") or your business name.
- Description (optional) a short piece of text under the title. This can be information you want to share, or a tagline, for example. Enter the description in the text box.
Scroll down to the Launcher section, where you can update the following:
- Position, where the launcher button appears in your browser window. Use the radio buttons to choose either Bottom right or Bottom left.
- Text (optional), text that appears next to the launcher button.
The Preferences tab
The Preferences tab is where you can set your Conversation history options. See About Conversation history.
The Installation tab
To add the Web SDK to your website
- Click the Installation tab, then click the Copy icon (
) at the bottom of the code snippet frame.
- If you want to add the widget to your website, go to the web page where you want to add the widget, then paste the code before the closing HTML
</body>
tag. Add the code to every web page where you want the widget to appear. - Make sure your firewall is configured to allow the web widget to appear.
To add the Web SDK to your Help Center
- Click the Installation tab, then click the checkbox to Automatically embed Web SDK in your Help Center.
About Conversation history
If you choose to enable the Conversation history feature for your customers, when an end user returns to the Web SDK or social messaging channel where conversations with your business have already taken place, the full text of those conversations remains visible to them.
6 Comments
I'm super excited about this new feature but I did want to ask: It says to paste the code on the page you want to use the messaging feature on but what if you want people to be able to access it on every page? Also, a true chat system gives you the options to have a " chat" pop up on a specific web page depending on some rules you make so would that be a possible option with the " flows" in messaging?
For example: If I have a customer browsing a page with " universal fitment" items and I want a chat to pop up and help them on that page, is that something I could build with messaging?
Is there any way to hide/show the widget? It appears the original web widget javascript methods (https://developer.zendesk.com/embeddables/docs/widget/core#hide) do not work with this new messaging widget.
Hi Erik Fantasia,
Not as yet but we are working on it. They should be available in the next couple of weeks!
- Miranda.
Previously with chat, the chat would disengage at our closing time, letting people know that we were not available and allowed them to email a request. With the messenger is there a way to do that? We turned it on initially and after our normal chat hours closed, people were still able to try to talk to a human, even though nobody was online in chat. Any way to do updates based on whether or not there is someone to serve them, or (even better) based on what time it is?
Hi @...,
1. If you're using the Zendesk Web Widget today, there's no need to change the script in order to use messaging. You'll just need to enable it within your Admin Center. If you're hoping to use it on every page, then you'll need to have the snippet load on every page of your website.
2. Proactive messages are something that we're currently thinking about. It isn't available within messaging today but it's something on our radar. If you have any specific feedback to pass along, please submit it to our feedback portal for future consideration.
Thanks,
- Miranda.
As Troy Willcox mentioned we don't want this happening either and we do not want to use answer bots for after hours.
Please sign in to leave a comment.