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

Getting Started with Flex Insights

This guide shows you how to enable and access Flex Insights and provides answers to frequently asked questions.

Enable Flex Insights

enable-flex-insights page anchor

Flex Insights is a paid feature that is included in Active User Hour and Named User Pricing Plans(link takes you to an external page). Before you can enable Flex Insights, you must upgrade your Flex project and select a pricing plan.

To upgrade your Flex project:

  1. From the Twilio Console, use the drop-down selector in the top-left corner to open your Flex Project.
  2. Select Upgrade Project .
  3. Complete the required information.
  4. Select Upgrade Account.


To select a pricing plan:

  1. From the Twilio Console, navigate to Flex > Pricing .
  2. Choose a pricing plan, then click Select Plan .

To enable and provision Flex Insights:

  1. From the Twilio Console > Flex > Pricing, select the link Click here to enable Flex Insights.

  2. Complete the fields, then select Provision Insights . Note: It may take a few minutes to complete activation.
  3. Flex Insights is now enabled. You can turn on the Call Recording capability as shown below to play back outbound calls in Flex Insights.

    Flex Insights Enabled.
  4. Log out and log back in to your Flex account.

For information on user provisioning and role assignment, see Flex Insights User Roles.



Flex Insights receives all of the events that are generated by your TaskRouter Workspace. While we populate many Insights data fields directly with values coming from TaskRouter, you can customize Insights with other data fields of your choice.

For more information, see Enhance your Flex Insights Integration.

Enabling Flex Insights adds the following pages to the Flex UI:

To access the Analytics Portal, open the Dashboards(link takes you to an external page) page from the left menu.

Flex Menu with Insights Pages.

Get the most out of Flex Insights. Check out these Flex Insights training courses:

Frequently Asked Questions

frequently-asked-questions page anchor

What's Included?

whats-included page anchor

Flex Insights Historical Reporting includes:

  • Custom Metric and KPI Definition : Define your own custom metrics and KPIs and customize existing metrics and KPIs to fit your business.
  • Custom Report Builder : Create custom reports and dashboards through an easy-to-use report builder.
  • Email-Based Alerting on Metrics : Define custom alerting thresholds on any metric and receive emails when thresholds are exceeded.
  • Pre-Built Reports and Dashboards : Analyze contact center performance through powerful built-in reports.
  • Report and Dashboard Exports : Export dashboards and reports as Excel, CSV, PNG, or PDF files.
  • Report Export API : Load your analyzed interaction data into your data warehouse through our REST API.
  • Reporting on Custom Interaction Data : Add context to, improve the richness of, and slice and dice your data by using custom attributes attached to an interaction.
  • Scheduled Dashboard and Report Emails : Schedule emails of Reports and Dashboards on a defined interval.

Agent Conversations Assessment features include:

  • Call Comments : Provide freeform comments and feedback on conversations to improve agent performance.
  • Conversation Player : Play back voice conversations that include annotations for agent scoring.
  • Quality Evaluation Questionnaires : Evaluate the quality of calls using customizable evaluation questionnaires.
  • Questionnaire Builder : Create quality evaluation questionnaires for call scoring.

Are Real-Time Analytics Available?

are-real-time-analytics-available page anchor

Flex Insights provides a historical view of conversations, enabling customers to aggregate data at different levels, identify short and long-term trends, and better understand the overall picture of contact center performance.

As opposed to operational reporting, Flex Insights provides analytical insights for process and workflow streamlining in the contact center.

Are Email and Chat Channels Supported?

are-email-and-chat-channels-supported page anchor

The Analytics Data Model supports multiple communication channels, including chat and email.

What Metrics Are Available?

what-metrics-are-available page anchor

Out of the box, Flex Insights captures and reports a number of metrics including abandoned conversations, handled conversations, and queue time. We update the list of built-in dashboards, reports, and metrics with each release.

Are Custom Fields Supported?

are-custom-fields-supported page anchor

Yes. Flex Insights consumes TaskRouter events data. This means that you need to pass custom data via task attribute updates. You can set up to five Custom Conversation Measures (numeric values) and up to seven Custom Conversation Attributes (text values) to hold custom conversation data. For more information, see Add custom attributes and measures.

Can You Listen to Individual Calls?

can-you-listen-to-individual-calls page anchor

Yes. You can drill down into individual conversations and open them with the conversation Player. In order to play a recording from a conversation, the recording file URL must be passed as a task attribute to Flex Insights. For more information, see Add links to recordings.

Are Agent Transfers Visible?

are-agent-transfers-visible page anchor

Yes. Flex Insights supports multi-segmented conversations containing cold transfers. You can see customer contact from the time a customer enters the queue to the end of the last call segment with an agent.

How Often Is Data Refreshed?

how-often-is-data-refreshed page anchor

The data refresh frequency is every 60 minutes.

How Can I Tell When Data Was Last Refreshed?

how-can-i-tell-when-data-was-last-refreshed page anchor

You can check this information via the Analytics Portal(link takes you to an external page) by navigating to Manage > Data > Datasets. The Upload Time column indicates the timestamp of the latest data upload. Please note that a data refresh only happens if new events were generated since the last upload.

Last Updated.

Note: You must have the role of Editor to access this tab.

What Is the Data Retention Period in Flex Insights?

what-is-the-data-retention-period-in-flex-insights page anchor

Flex Insights has a data retention period of at least 24 months for customers that have less than 2,000 agents and do not add a lot of additional custom data. The data retention can be shorter for accounts with a large number of agents and when providing a lot of additional custom data. Learn more about the Flex Insights limits.

Are Multiple Twilio Account SIDs Supported in a Single Dashboard?

are-multiple-twilio-account-sids-supported-in-a-single-dashboard page anchor

Each account has data in an isolated Flex Insights workspace. Data from different Flex Insights workspaces can not be used in a single dashboard.

How Do I Move Flex Insights to a New Account?

how-do-i-move-flex-insights-to-a-new-account page anchor

Contact Twilio Technical Support in advance for assistance.

My Question Is Not Listed Here. Who Can Help Me?

my-question-is-not-listed-here-who-can-help-me page anchor

Please contact the Flex Insights Support Team(link takes you to an external page). We will be happy to assist with your inquiries!

Rate this page: