Flex Insights (also known as Historical Reporting) is currently available as a public beta release and the information contained in the Flex Insights documentation is subject to change. This means that some features are not yet implemented and others may be changed before the product is declared as generally available. Public beta products are not covered by a Twilio SLA.
Any reference to "Historical Reporting," "Flex Insights API," "Flex Insights Historical Reporting," or "Flex Insights Historical Reporting API" in the Flex Insights documentation refers to Flex Insights.
You can use Workload Reporting to get granular information about agent activity in a given day. Workload reporting slices conversations and agent activity (agent status data) into 15-minute intervals to attribute the time an agent spent working on a conversation or in a given state. You can also segment Workload data by 30 minutes, 1 hour, and by date.
Workload data is updated after every load and reflects the data from the last finished time period. For example, hourly loads show Workload data for the complete hour that precedes the load. 15-minute loads show Workload data for the last complete 15-minute interval that precedes the load. This means that Workload data is also available for and may reflect conversations and activities that are still in progress.
Segments in the Conversations data set that are still in progress have Kind set to Conversation in Progress or Agent Status in Progress. By default, Flex Insights excludes Segments that are in progress from workload reporting, as they do not have a final set of attributes and measures.
Workload reporting uses data objects from the Workload data set and can be categorized into two types of workloads: Conversation Workload and Agent Activity Workload.
Workload Kind is the kind of the original segment related to this workload. The following is a list of possible values:
Queue, Conversation in Progress, Agent Status in Progress, Missed Conversation, and Rejected Conversation Segments do not produce Workload objects.
Conversation Workload allows you to accurately attribute the time agents spent on conversations during the day.
The predefined Conversation Workload measures are as follows:
Because Conversation Workload data is connected to Conversations data, you can also segment and filter the Conversation Workload by all attributes that are available in the Conversations data set. This allows you to flexibly attribute what kind of conversations agents spend their time working on.
All Conversation Workload data objects have Kind set to Conversation. This means that the sum of Talk Time and Wrap Up Time in the workload is equal to the Talk Time and Wrap Up time in the conversation that the Workload breaks down. This applies only to completed conversations and not to conversations that are still in progress.
The Agent Activity Workload provides you with accurate details on which activities (statuses) that agents were in during the day and how many conversations they were handling during a given time frame. These details enable you to check the following:
The predefined Agent Activity Workload measures are as follows:
Some measures such as Idle Time and Offline Time depend on variables that are account specific. The following variables are account specific:
These preferences can only be changed by Twilio. If you need to customize these preferences, please contact Twilio support.
In most reports, Flex Insights uses the default Date and Time measures. To report on workload-related measures, you can use the (new) Date - Workload and Time - Workload dimensions.
This chart shows how Workload Activity Time is reported using Date - Workload and Time - Workload dimensions. Time - Workload provides a more granular view on the actual agent load over the period of time shown in the chart. The bar chart on the top shows how the Workload Activity Time is attributed to time intervals using Time dimension. The bar chart underneath shows how Workload Activity Time is attributed by using Time - Workload dimension. The colors in the bar charts correspond to the colors in the timeline at the bottom.
In the Report Builder, use Date - Workload and Time - Workload in the How section to segment the workload by the time interval in which agents were handling a conversation or were in a given agent status.
To build Workload reports in Analyze view:
Drag and drop the Date item to any place in the report.
Click on the Date item that you dropped in the report.
Click Date as to get the list of available date dimensions.
Choose Date - Workload from the list and select Apply.
You can use Workload data and custom measures to build a variety of interesting reports. Here are three perspectives on the same agent's morning for inspiration.
The table above provides the following information:
The segments (rows) in the table below are produced from the Conversations data set and are based on the example above (Example 1). The table lists a few attributes and measures that are important for workload reporting. It does not list all available attributes and measures that are available in the Conversations data set. You could use this table to understand your basic data while building custom measures and further reports.
Only Conversation and Agent Activity (status) segments produce workload data objects. Segments of the Kind Queue, Missed Conversation, and Rejected Conversation do not produce workload data objects. The following example demonstrates this by showing Workload data for all segment kinds except for Queue:
Each conversation and agent status segment produces one or more items in the Workload data set. Because the Workload data set references the Conversations data set, segmentation by attributes in the Conversation data set is available. Like the Conversations Data table above, consider using a similar table to understand your basic data while building custom measures and further reports.
Conversations in the Workload data set are split by any 15-minute interval boundary while the agent is handling a conversation. Talk Time and Wrap Up Time attributes represent time spent in those parts of the conversation within the given interval.
Agent Activity (status) in the Workload data set is split by any of these events:
Agent Activity items have an Activity Time measure that contains time spent in the activity between any of the events above. Parallel Conversations is a measure that contains the number of conversations an agent was handling at that time. This includes all activity from when a Reservation was accepted until the Reservation was completed, including Wrap Up.
All columns in the table below show data produced from the Workload data set. The colors in the table correspond with the Conversation data set in the table above (Example 2).