add-chat-widget.md

title	description	ms.date	author	ms.author	ms.reviewer	ms.topic
Configure a chat widget	Learn how to configure a chat widget in Dynamics 365 Contact Center.	02/05/2025	neeranelli	nenellim	nenellim	article

Configure a chat widget

[!INCLUDEcc-feature-availability-embedded-yes]

[!INCLUDEcc-rebrand-bot-agent]

You can configure a live chat widget that can be displayed on your portal for customers to interact with AI agents and customer service representatives (service representatives or representatives).

To add a chat widget, configure a workstream that defines how chat conversations are routed to queues. Learn more in Create a workstream.

Configure a chat widget

1. In the site map of Customer Service admin center or Contact Center admin center, select Channels in Customer support. The Channels page appears.

2. Select Manage for Chat. The Chat channels page appears.

3. Select Add chat channel.

4. On the Channel details page, enter a name and select a language in the Name and Language fields, respectively.

5. On the Chat Widget page, enter the following details:

   • Title: Display name for the chat widget.
   • Subtitle: Other title, such as "We're online".
   • Theme color: Choose a color from the list.
   • Logo URL: Select the default value or enter the link to the logo that you want to be displayed.
   • Agent display name: Select a value from the list.

   [!NOTE] You can customize the chat widget appearance using data tags. Learn more in Customize live chat widgets using data tags.

6. Switch the toggle to Yes to enable the following options:

   • Proactive chat
   • Reconnect to previous chat
   • Only show widget during operation hours
     • Operation hours name: Select an operating hour setting. Learn more in Configure operating hours.
   • Only show widget on the provided domains: Enter the link of the portal.

7. On the Behaviors page, configure the following options:

   • Custom automated messages

   • Pre-conversation survey

   • Post-conversation survey

   • Authentication settings

   • Customer wait time

     [!Note] These settings aren't configurable for the persistent chat feature. Learn more in Configure persistent chat.

     • Show position in queue: Select to show customers their position in the queue when they're waiting to interact with a service representative. Learn more in Show customers their queue position.
     • Show average wait time: Select to display the average wait time in the queue when customers are waiting to interact with a representative. Learn more in Show customers their average wait time in a queue.

   • Customer location detection: Select a location provider. Learn more in Set up visitor location detection.

8. On the User features page, configure the following options:

   • File attachments

   • Customer notifications

   • Conversation transcripts

   • Voice and video calls: Switch the toggle to On and select the calling option.

   • Screen sharing: Switch the toggle to On and select a provider.

   • Co-browse: Switch the toggle to On and select a provider if you want the representatives to see and interact with a customer's web browse.

     [!NOTE]

     • You must install a non-Microsoft provider from AppSource to use the screen sharing or co-browse feature.
     • You can select only one co-browse provider and or one screen sharing provider for each chat widget. Solutions published on Appsource only appear in the lists.

9. On the Review and finish page, review the channel settings, and select Create channel.

Configure customer notifications

You can configure visual and sound alerts that customers can receive when they're interacting with representatives using the chat widget on your organization portal. If the chat window is minimized or inactive, the system plays a sound notification when the representative sends a message. The customer also sees a count of the unread messages.

Do the following steps to enable the customer notifications:

1. In Customer Service admin center or Contact Center admin center, edit a chat widget, and on the Chat channel settings page, select the User features tab.
2. For Customer notifications, switch the toggle to On. The following checkboxes are displayed as selected:
   • Show number of new messages
   • Play sound notifications for new messages
3. Keep the default settings or select one of them depending on your requirement.

You can also configure the customer notifications when you're configuring the chat channel.

Troubleshoot

Errors in creating a chat widget

Related information

Configure a pre-conversation survey
Configure agent display name
Configure proactive chat
Configure file attachment capability
Create quick replies
Create and manage operating hours
Create chat authentication settings
Embed chat widget in your website or portal
Embed chat widget in mobile experiences
Supported browsers for live chat widget

[!INCLUDEfooter-include]