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.
Understand how Flex Insights splits voice conversations into segments and how it calculates handling time. Conversations are the backbone of the Flex Insights Analytics Data Model.
A Segment
is an atom of any conversation. A segment represents an interval in time dedicated to certain phases during a Conversation
.
Segments
can be of different Kinds
:
Queue Segment
(Kind
=Queue
)
Conversation Segment
(Kind
=Conversation
)
A Conversation
represents communication between one customer and any agents with whom they interact within the contact center.
A conversation where one customer speaks to one agent will be composed of (at least) two segments:
In a call with one cold transfer, the conversation will typically have four segments (2 of Queue & 2 of Conversation kind segments):
Conversations can be further organized into Cases
, Projects
, Campaigns
and Initiatives
, which provide higher-level groupings of Conversations. For more details, check out the Flex Insights Analytics Data Model.
Handling Time
is the time an agent spends handling a customer task, including wrap-up work that happens after the task is completed.
Handling Time
- The time agents spend handling a customer task.Experience Time
- The time a customer spends trying to resolve their issue, including time spent in queue and time communicating with your agents.Depending on the communication channels involved, all handling and experience time information may not be available.
Your agents will make outbound calls when they do cold calling, warm calling, or reach out to your customers.
Handling Time
of an Outbound Conversation is the sum of Ring Time
, Talk Time
and Wrap Up Time
.
We include Ring Time
in the total handling time, as your agent is blocked from other activities when trying to reach customers.
If a dialer places the call, the time the dialer spends ringing is not included in Ring Time
and therefore not included in Handling Time
.
When a customer calls your contact center, they can go through a sequence of steps depending on your infrastructure.
Usually, the following activities occur. A Twilio phone number is dialed and, depending on the phone number's configuration, the customer can go to an IVR. If the customer was not able to solve their problem, they queue up to wait for an available agent. This all happens before the customer speaks with an agent.
Handling Time
for inbound conversations does not include Ring Time
as the agent is not blocked at the moment. Handling Time
starts when the customer connects to an agent.
Ring Time is part of Queue Time in Flex Insights. Queue time ends when a call is answered by an agent.
IVR Only conversations are conversations where customers managed to solve their request using an IVR application or they were not successful and just gave up before entering a queue.
Handling Time
for IVR-Only conversations is always zero
.
Time spent in an IVR is not captured in Flex Insights by default. In order to surface IVR related metrics, you'll need to pass them through TaskRouter events as attributes.
If an agent cannot handle a customer request for some reason, they can forward it to another agent or a queue.
For example, a Level 1 support agent can transfer customers with very technical questions to the Level 2 support queue.
A conversation
with a transferred call normally has 4 Segments.
Handling Time represents how much time your agents spend handling the customer's inquiry. The Handling Time of this conversation is the sum of the Handling Times of two conversation segments (where Kind
=Conversation
), even when the Handling Times overlap because they are handled by two agents.