TABLE OF CONTENTS
- Plan-wise availability
- 1. Create widgets
- 2. Adding Topics and FAQ categories to the widget
- 3. Customize your widget
- 4. Advanced configurations for the web widget
- 5. Embed page
- 6. Bot mapping
Note: 'Web widget' and 'conversations widget' refer to the same Freshchat widget and can be used interchangeably.
Note: You must manually add Topics and FAQ categories to the widget when you create a new Topic/FAQ category.
Freshchat allows you to create and deploy multiple widgets. This enables you to offer personalized support to your customers.
For example, the support experience on your ‘product listing’ page may need to be different from the one on your order tracking page. Similarly, if you operate multiple brands, the support experience for each of them needs to be unique.
With multiple widgets, customers can have unique experiences on different pages, tailored to their needs at the time. Let’s look at how to set up and manage multiple widgets on Freshchat.
Plan-wise availability
The following features are available on the Growth plan and above:
- Multiple widgets
- FAQs
- Hide branding
All other conversations widget features are available on all plans.
1. Create widgets
- Navigate to Channels > Web Widget to create and configure widgets. The default web widget is already available for configuration. You can choose to configure the same or create a new widget.
- To create a new widget, click the ‘New widget’ button and follow the instructions.
- You can choose to clone or delete a widget by clicking on the ‘options’ button next to each widget.
2. Adding Topics and FAQ categories to the widget
Once you have created a widget / chosen the default widget, you can now choose to configure the same. The first step is to configure the main content of the widget, which includes topics and FAQ categories.
- Click on the widget of your choice > Content tab
- You can now add/remove Topics and FAQ categories for the widget. You can also change their order.
- To manage topics for the web widget or learn more about topics, check out What are Topics in Freshchat.
- To learn how to manage FAQ categories and articles, check out How to create FAQs
3. Customize your widget
You can customize your widget under the ‘Appearance’ tab. You can modify the branding on your widget and its position and behavior.
a. Change branding
Your brand design must reflect on each customer touchpoint, including your web widget. You can customize the look and feel of your widget on this page. On the ‘Appearance’ tab, click on ‘Branding’ to edit the following:
![]() |
|
b. Change Position/behavior
Click on the ‘Position and behavior’ tab to edit the following:
![]() |
|
c. Custom CSS
4. Advanced configurations for the web widget
- Click on the ‘Advanced options’ tab to customize the following actions for the web widget.
- Trusted domains: Trusted domains enable you to choose where to load your web widget from Freshchat. With trusted domains, you can ensure that your widget can only load on the specific domains you trust.
- Typing indicator: Typing indicators will display an agent typing indicator for your customers.
- Browser notification: Toggle this to on and alay browser notification sounds when your customers receive a message.
- Notification sound: Toggle this to on and play notification sounds when your customers receive a message.
- Allow customers to attach files: Toggle this to on and allow your customers to send files as attachments.
- Hide resolved conversation history: This flag will hide the conversation history for resolved conversations.
- Show privacy policy: This flag will show a link to your privacy policy in the conversation page
5. Embed page
- To enable the widget for your customers, you need to embed its code on your website.
- Click on the 'Embed' tab to access your unique code snippet.
- Paste the code snippet on every page of your website where you want your Freshchat web widget to appear.
- You can also get the code for user properties and bot conversation properties from this page.
- For bot conversation properties, please save the topic mappings before generating the code for the same.
- For advanced customizations, visit our developer documentation here.
6. Bot mapping
You can link topics to bots seamlessly from the widget list page. You can further configure advanced options from the topics page. This mapping applies to all the widgets.
Message Types Supported:
Message Type | Direction | Web - Conversations Widget | Web - Self-Service Widget |
Text | User to agent | Yes | Yes |
User to Bot | Yes | Yes | |
Agent to user | Yes | Yes | |
Bot to user | Yes | Yes | |
Image | User to agent | Yes | Yes |
User to bot | Yes | Yes | |
Agent to user | Yes | Yes | |
Bot to user | Yes | Yes | |
Video | User to agent | Yes | Yes |
User to Bot | Yes | Yes | |
Agent to user | Yes | Yes | |
Bot to user | via public URL | via public URL | |
Audio | User to agent | Yes | Yes |
User to bot | Yes | Yes | |
Agent to user | Yes | via App | |
Bot to user | Yes | Yes | |
File | User to agent | Yes | Yes |
User to bot | Yes | Yes | |
Agent to user | Yes | Yes | |
Bot to user | Yes | Coming soon | |
Emoji | User to agent | Yes | Yes |
User to bot | Yes | Yes | |
Agent to user | Yes | Yes | |
Bot to user | Yes | Yes | |
GIFs | User to agent | Yes | Yes |
User to bot | Yes | Yes | |
Agent to user | Yes | Yes | |
Bot to user | Yes | Yes | |
Stickers | User to agent | NA | NA |
User to bot | NA | NA | |
Agent to user | NA | No | |
Bot to user | NA | No | |
Automation | Bots | Yes | Yes |
Structured Messages | |||
Articles | Bot to user | Yes | Yes |
Carousels | Bot to user | Yes | Yes |
Buttons | Bot to user | Yes | Yes |
Dropdown List | Bot to user | Yes | Yes |
Message events | |||
Delivered | User to agent | No | Yes |
Agent to user | Yes | No | |
Read | User to agent | Yes | Yes |
Agent to user | No | No | |
Typing | User to agent | Yes | No |
Agent to user | Yes | No | |
Consumer Profile | |||
User Name | Yes | Yes | Yes |
User Image | NA | NA | No |