Flex Insights FAQ

How do I get started with Flex Insights?

Flex Insights is a feature of Twilio Flex that is available when you sign up for a paid Flex plan. You can find more details on enablement here. Flex Insights receives all 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. The best way to get started with customization is to take a look at the way Task attributes are consumed by Insights when you enhance your Flex Insights integration.

What's included in Flex Insights?

Historical Reporting

  • 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: Quickly 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 that threshold is exceeded.
  • Pre-Built Reports and Dashboards: Analyse the performance of your contact center through powerful built-in reports.
  • Report and Dashboard Exports: Export dashboards and reports as an Excel File, CSV, PNG Image or PDF.
  • 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 & 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 Conversation Assessments

  • Call Comments: Provide freeform comments and feedback on conversations to improve agent performance.
  • Conversation Player: Play back voice conversations, with annotations for agent scoring.
  • Quality Evaluation Questionnaires: Evaluate the quality of calls using customisable evaluation questionnaires.
  • Questionnaire Builder: Create quality evaluation questionnaires for call scoring with an easy-to-use creation tool.

How do I access Flex Insights?

You can access Insights reporting directly from Flex by clicking on the Analytics icon ( More advanced analytical users can access the Analytics Portal, which provides extended analytical features.

How long does it take to enable Flex Insights?

It typically takes a few minutes to enable Flex Insights. You can check readiness status at the page. Once Insights is ready you should see:

WFO Ready

The next step, following Insights activation, is to make sure you log out and log back into Flex to enable your user access to Insights. Read more on Flex Insights User Access here.

What Metrics are available through Flex Insights?

Out of the box, Flex Insights captures and reports a number of metrics including abandoned conversations, handled conversations, queue time, and more. We're updating the list of built-in dashboards, reports, and metrics with each release. Please check the Release Notes document to find the most recent version of the document.

Are custom fields supported in Insights?

Flex Insights consumes TaskRouter events data. This means you need to pass custom data via task attribute updates. Learn how this can be done in this article. Users can add custom task and worker attributes to collect the right data for their reporting needs. 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. Before passing value through a custom field, ensure there is not already an existing attribute or measure in the Analytics Data Model that satisfies your requirement.

Are Agent Transfers Visible in Flex Insights?

Yes. Flex Insights supports multi-segmented conversations containing cold transfers. It's possible to see customer contact from entering the queue all the way through the end of the last call segment with an agent.

Are multiple Twilio Accounts SIDs supported in a single dashboard?

Data from individual Twilio Accounts are isolated and can not be merged. If you are planning to switch to another account SID please plan and coordinate ahead of time with Twilio Technical Support, to ensure a new Insights instance is built for the new account in order to not lose data during the transition.

Is it possible to listen to individual calls in Insights?

Yes. You can drill down into individual conversations and have them opened in Player. In order to play a conversation's recording, the recording file URL must be passed as a task attribute to Flex Insights. Please see this article for the details.

Do you support emails and chats?

Our Analytics Data Model is ready for multiple communication channels, including chat and email.

How regularly is data in Insights refreshed?

The default data refresh frequency is every 60 minutes, at the top of the hour.

How can I tell when data was last refreshed?

You can check this information via the Analytics Portal by navigating to Data -> Datasets. The Upload Time column indicates the timestamp of the latest data upload. Please note that a data refresh will only happen if new events were generated since the last upload.

Last Updated

The Editor analytical role is required to access this tab.

Is there real-time analytics in Insights?

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, Insights is providing analytical insights for process and workflow streamlining in the contact center.

What is the data retention period in Flex Insights historical reporting?

Flex Insights data retention is 24 months.

My question is not listed here. Who can help me?

Please contact the Flex Insights Support Team at, and we will be happy to assist with your inquiries.

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.