- If you currently use live chat, see Creating a messaging Web Widget when using live chat and Web Widget (Classic).
- If you don't use live chat and your account was created before November 2, 2021, see Creating a Web Widget in accounts prior to November 2021.
You use a Web Widget to offer messaging functionality to your customers through a website or help center. A default Web Widget already exists for you to set up and install. You must be an admin to set up a Web Widget.
If you support multiple brands and want to create a Web Widget for a brand, see Adding Web Widgets to multiple brands.
To set up the Web Widget for messaging
-
In Admin Center, click
Channels in the sidebar, then select Messaging and social > Messaging.
A basic Web Widget named
Zendesk
is created by default and appears in the Channels list. - Click the default widget in the Channels list.
- Under Start with the basics, confirm or change the Channel name, then click Next.
- Under Install on your site, take an action or skip this step if you plan to
install later, then click Next.
- For your website, copy the code snippet to paste in your website now or click Email code to team member to send the code to yourself or a team member.
- For your help center, select Automatically embed Web Widget in your help center. You won't see this option if you haven't activated your help center.
If you're not ready to install the widget now, you can always do it later.
- Under Make it your own, configure the settings, then click Next.
- Select a Primary color for the launcher and header by using the color picker or by entering a hexadecimal number.
- Enter a Title that will appear in the header of the Web Widget.
- Upload an optional Logo.
The Web Widget updates in the Preview panel as you make changes. You can also click Test it now to see how the Web Widget will look to your end users.
- If the See what you’ve done so far window appears, click Done.
In the Web Widget page, you can configure the widget settings or leave it as-is for now.
If you installed the widget, it's immediately available on your website or help center. Otherwise, you can install the widget on your website or in a help center at a later date.
28 comments
WhitePages - whitepages
How do you delete a messaging web widget?
2
Miranda Burford
Hi Walter,
By delete, do you mean remove the Web Widget listing from the Channels list in Admin Center? This isn't possible today but it's something that we are considering in the future.
If you want to remove the widget from your website, then you should delete the code snippet from loading on each page. This won't remove the listing from the Channels list though.
Thanks,
- Miranda.
2
WhitePages - whitepages
Hey Miranda,
Thanks for the quick response!
Yes, that's what I meant. I was testing and now have a widget in my view that's obsolete but not a huge deal.
Thanks again.
1
Miranda Burford
Thanks Walter. Appreciate the feedback. This is something that we are hoping to address in the future (no timeframes that I can provide at this stage though).
- Miranda.
0
Cheryl Hoskins
Can you change the height of the messaging web widget? For example, I notice on Zendesk site on mobile, the widget takes about half of the height in portrait. But on our site, the widget takes the entire viewport height.
0
Christine
If you are using the Web Widget, currently the customization is limited to the following:
Configuring the widget frame
Configuring the widget launcher
At this time it is not possible to change the size (height) of the Web Widget.
0
Gabriela
How can we hide 'Powered by Zendesk" message from the messaging web widget? The message wasn't there until today. Thank you
0
Tyler Heckman
How do I change the offline message when the messaging bot can't connect to an agent? Right now it says "Hi there! Thanks for reaching out to us. We're offline right now, but we'll respond to your message when we're back online in a few hours" and we want to change it
0
Arianne Batiles
Hi Gabriela,
If you are referring to the Zendesk logo in the messaging widget, you can uncheck the "Show Zendesk logo" found in the Admin Center > Messaging > Choose a widget > Style tab.
0
Arianne Batiles
Hi Tyler Heckman,
You can change the All Agents Offline trigger in the chat dashboard.![](/hc/user_images/87abOLuElQEM03Z1vtz5PA.png)
0
Kenya Roberts
For the main color of the widget bubble, how can we make the inside chat bubble icon/words be white instead of black?
Also, how do you change the icon or headshot that appears to the left of the agents responses?
0
Viktor Osetrov
Unfortunately, we don't have a native solution, except "Style" web widget option.
Technically, its possible to solve this task via some custom HTML/CSS/JavaScripting.
You should add a new CSS rules like that via your website DOM manipulations:
Have attached an example
Hope for your understanding
1
Kenya Roberts
Thank you. But what about the icon/headshot to the left of agent responses? Can we customize this?
0
Viktor Osetrov
Yes, you can customize it natively via "Style" settings.
Just choose "Frame" -> "Position" -> "Bottom left"
Hope it helps
1
Leo Medalla
Is there a way so that the chat widget when opened that it doesn't cover the entire screen when on Mobile Devices (smartphones)
0
Marko Ilic
Hello, is it possible to send organization name and id in user token along user external_id, name and email, so Zendesk could recognise which organisation user belongs?
Example:
1
Evelyn Flynn
I've asked in the dev community about this but thought I might as well post here too. Is there currently any way to do version pinning when implementing the web widget on our site? (if we want to only use a certain version of the code)
0
Mike DR
Base on our article: Enabling authenticated visitors for messaging with Zendesk SDKs, it does show in the example that you can add the
external_ID
0
Adrian
Hello,
I need some help please. I added the Web Widget to our Help Centre, but when customers send messages and all agents are offline/invisible, the messages are not converted into tickets and the chats from the customer's side remain open.
How can I set please the Web Widget to convert messages into Tickets. We do not wish to have live chat, but we want the web widget. In our other help Centre we had the Classic Web widget and that was doing it. Can you please advise how I can do it on the new plans.
3
Technical Specialist
hello, i want to test my answer bot and I'm prompted to create a Web Widget from the Messaging page, but I don't have the page,
0
Dainne Kiara Lucena-Laxamana
Hi Technical Specialist !
I went ahead & created a ticket on your behalf to look into the Messaging page further. Please keep an eye out for our update on that ticket
0
Technical Specialist
Hello
Our team has purchased "support" professional seats, along with some additional components. Now, we're interested in integrating artificial intelligence. However, the documentation states that only the "suite" package allows the use of AI (presumably because messaging functionality is exclusive to the "suite"). I'd like to inquire if there's any method to utilize AI within this plan without purchasing the "suite."
0
JR Lausin
Thanks for contacting Zendesk Support!
You might want to check Advanced AI it's an add on in your account so you can use bot please check this article.
https://support.zendesk.com/hc/en-us/articles/5524125586330-About-Zendesk-Advanced-AI
0
Danielle Hogan
We are looking to remove the messaging web widget from all our web pages and instead insert a link to live chat(messaging) on specific pages only. Does the growth plan or any plan allow for this type of customization?
0
Kin
Hi Danielle,
To answer your question, yes this is possible for Growth plans.
If I may direct you to our article here, regarding your concern.
Please note that by using this method, since you are using Messaging this will just open the widget on a new page and not a direct link.
0
Permanently deleted user
how to pass user context when using zendesk messaging on website chat widget.
for example I want to set up flows that can utilize which product page the customer is initiating the website chat from. How do I pass product 1 to be able to set the context for the covnersation?
0
Joselo Torres Landa
when I go to Zendesk, I do NOT have a Web Widget named
Zendesk
0
Chris Jookar
I am working in my Sandbox to test our widget. I am testing and submitting tickets through the widget in the admin center but I am not seeing the tickets come through on the other side. I cant find them at all.
Not sure if I am doing something wrong on my end or if tickets just aren't able to be created this way in the sandbox. Just wanting to test it out first before we go live with it.
Any ideas anyone?
1