Skip to contentSkip to navigationSkip to topbar
On this page

Flex UI and Flex Plugins


(warning)

Warning

For Customers building HIPAA-compliant workflows with Flex UI, Customers are responsible for ensuring that in the case that PHI will be exposed through Flex UI, that only those that are authorized to access PHI have access to Flex. In some scenarios, PHI may be available to be downloaded by an Agent to their workstation from Flex UI. It is the responsibility of the customer to ensure that those with access have proper training on HIPAA prior to being given access. To learn more about building for HIPAA compliance, please visit the latest requirements here(link takes you to an external page).


Flex UI Programmability

flex-ui-programmability page anchor

The Flex UI allows developers to build a custom user experience and custom behaviors for the Flex agents and supervisors. You can leverage a set of client-side public interfaces(link takes you to an external page) to customize the look and feel, alter the behavior, and introduce additional features to the out-of-the-box experience.

The Flex UI provides a wider range of programmable capabilities:

  • Configure the UI or manipulate default properties for standard Flex components
  • Customize themes and styles
  • Control localization and templates
  • Add, replace, or remove components
  • Take advantage of UI actions by listening, intercepting, and manipulating UI events
  • Customize agent desktop notifications using the Notifications Framework
  • Alter the behavior and appearance of native channels and define custom ones with the Task Channel Definitions API
  • Mix in Task or Theme context to your custom components
  • Leverage the Flex Manager object to get access to and control underlying SDKs

You can find a detailed description of all the Flex UI programmable interfaces in our API Docs(link takes you to an external page) and a collection of developer guides with examples of how to use them.

(information)

Info

You can see which version of the Flex UI you are currently using on the Flex Overview(link takes you to an external page) page in your Twilio Console:

Flex version in twilio console.

(warning)

Warning

For Customers building HIPAA-compliant workflows with Flex Plugins, Customers are responsible for ensuring that any plugin developed and used are done so in a HIPAA compliant manner. This also includes not inserting PHI into error messages that may be collected by Flex (or any other third party services) for debugging and/or troubleshooting purposes. Twilio cannot guarantee plugins developed by a third-party, regardless of whether they are an official partner of Twilio or not, are HIPAA compliant. Plugins developed by Twilio Professional Services must not be assumed were developed with HIPAA considerations. It is the responsibility of the customer that wishes to use such plugins to ensure they are developed and used in a HIPAA compliant manner. To learn more about building for HIPAA compliance, please visit the latest requirements here(link takes you to an external page).

Flex Plugins are the recommended way of customizing the Flex UI. Plugins have access to all of the frontend APIs: adding and replacing components, using the Actions Framework, triggering notifications, and more. They also provide a few additional benefits:

  • Plugins can be applied to any running Flex instance. This lets you use the same plugins across projects that simulate dev/stage/prod environments, and it's also the preferred path for any partner integration.
  • It decouples the customizations from individual flex-ui versions. As new versions are released, the plugins do not need to be rebuilt and redeployed.
  • It allows for modular development. Plugins can be scoped to particular pages, personas, or functions to help separate concerns.

Flex provides the following tools to help you build and manage your Plugins:

  • The Flex Plugin Library is a collection of readymade plugins that can be installed in a few clicks.
  • The Flex Plugins CLI is an interface for developing, testing, and releasing plugins.
  • The Flex Custom Plugins Dashboard enables admins to manage their custom plugins, view the history of custom plugin releases, and roll back to prior deployments.
  • The Flex Plugins API powers the CLI and the Dashboard.

Next Steps

next-steps page anchor

Need some help?

Terms of service

Copyright © 2024 Twilio Inc.