Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Use Chat and Messaging



This guide is for Flex UI 1.x.x and channels that use Programmable Chat and Proxy. If you are using Flex UI 2.x.x or you are starting out, we recommend that you build with Flex Conversations.

Flex supports various messaging channels, including SMS, Web Chat and WhatsApp. Using Flex, a contact center agent can handle multiple messaging tasks at one time.

Flex provides multiple features that help agents handle messaging channels more efficiently, like:

  • Customer presence indicators
  • Typing indicators
  • Markdown support
  • In-app and browser notifications
  • Unread message count badges

Customer presence

customer-presence page anchor

Customer presence indicator allows agents to see a Web Chat customer's connection status (online or offline) in real-time.



In order to use the Customer Presence feature, you'll need to enable a Reachability Indicator in your Programmable Chat service instance. So, if Customer Presence is not displaying an online status, make sure that the Reachability Indicator is enabled!

Agent Desktop View

Agent will be displayed an indicator in the Task List and Task Canvas Header. It will show a green icon if the customer is online, and a gray one if offline.

Teams View

A Supervisor, when monitoring Web Chat tasks, can see a customer presence indicator in the Task Canvas Header.

The agent will see a typing indicator if a participant (customer or another agent) of a Web Chat channel is typing.

The agent can see a typing indicator in the Task List and in the Messaging Canvas.

Markdown support allows agents to format Web Chat messages. This can improve the readability of longer messages. Using bold text, italics, or bulleted lists can create structure and emphasis in your agents' messages, and ensure that customers read and understand the message correctly.



Starting from @twilio/flex-ui@1.26.0, Markdown is a Generally available feature and can be turned on/off using Flex settings. Go to Flex Settings(link takes you to an external page) to enable markdown.

Additionally, the Web Chat user must be using WebChat v2.2 or later to see markdown-formatted messages.

Markdown support configuration for customers' side is disabled by default and needs to be turned on using the following configuration option:

markdownSupport: {
enabled: true,

Agents can add Markdown to their messages by using Flex standard syntax.

Flex Standard Markdown Syntax

flex-standard-markdown-syntax page anchor
Bullet list* List

* List

* List
Ordered list1. List

2. List

3. List
Code block`code block`

Messages using Flex markdown syntax can also be sent into the Chat Channel with the Programmable Chat REST API. API-generated messages will be displayed for Flex and WebChat users as formatted text.

In-app and browser notifications

in-app-and-browser-notifications page anchor

In-app and browser notifications help agents respond to tasks that require their attention in a timely manner. Notifications improve response time and help create a smooth customer experience.

Agents will be notified of the following activity regarding messaging tasks:

  • New messaging task created
  • New message in a messaging task posted by another participant


Starting from @twilio/flex-ui@1.26.0, browser notifications is a Generally Available feature and can be turned on/off using Flex settings. Go to Flex Settings(link takes you to an external page) to enable browser notifications.

In-app notifications for new tasks

in-app-notifications-for-new-tasks page anchor

If an agent is offered a new messaging task while they are navigated away from the Agent Desktop View, an in-app notification will be shown in a status bar below the header.

The agent can accept or reject the new task from the notification.

In addition to in-app notifications, a badge will also be shown on the Side Navigation to indicate that new tasks are available.

In-app notifications for new tasks.

Agent will receive a browser notification if:

  • A new messaging task comes in while Flex is not in focus, or
  • A new message appears in an active messaging task while Flex is not in focus
Browser notifications.

Enabling Browser Notifications

Agents will be prompted to enable browser notifications each time they log in or refresh the page. Once they choose to allow or block browser notifications, they will no longer see the prompt.

The Flex UI also provides an interface for developers to customize in-app and browser notifications. Find out more about the Flex Notifications Framework.

Flex will display an unread message count in the Task List to indicate whether the agent has any unread messages in an active messaging task. This allows the agent to see if there has been any activity in the messaging task without clicking on the task itself.

Side Navigation will show a badge without a count if there are new unaccepted tasks or unread messages in any of the active messaging tasks in Agent Desktop View.

Rate this page: