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


This section covers common reporting requirements for a contact center.

There are two types of common reporting interfaces:

  • Real time Dashboards - primarily visual graphs - described here
  • Historical reports - primarily text based tables - described in this document

Twilio has a set of partners who can provide out of the box dashboards end reports, or you can build these yourself using the data and tools Twilio makes available.

For each recommended graph or table, this document lists how you would derive this from the TaskRouter event stream, OR how you would get it from the TaskRouter statistics APIs. You would typically use one mechanism or the other, dependent on what technology you are using for building this.

The following reports are typically used by call center operational staff doing quality management and planning. In a small call center that may be the same person as the supervisor, but in larger call centers it is typically different people.

It is useful to be able to pull these reports on demand through a web interface, but many operational staff will want them emailed to multiple email addresses as a PDF (or formatted email) on a defined recurring schedule.

All these reports are typically tabular by default, unless otherwise specified.

In most cases these reports cover tasks of multiple channel types. It is beneficial to be able to either break out each report by both cumulative tasks and broken down by channel type (voice, sms, etc) - or to allow the viewer to specify which view they want.

Agent Summary Report

agent-summary-report page anchor

The Agent Summary report enables the user to view a summary of agent activity across standard key performance indicators. This report should be a table sorted by Agent

The report includes:

  • Agent name (or number if no name)
  • Queue name
  • Min task handle time
  • Mean task handle time
  • Max task handle time
  • Mean alerting time
  • Total tasks offered
  • Total tasks answered
Agent NameAvg Task Handle TimeMin Task Handle TimeMax Task Handle TimeAvg Idle TimeAvg Wrap UpTasks OfferedTasks AnsweredOutbound TasksAvg Outbound Time
Janie Smith0:02:220:00:310:05:550:05:240:00:25959430:03:33
Pam Anderson0:03:330:00:450:04:450:07:240:00:23808020:01:45

The Task Detail by User report displays call records for each agent. This report is generated in date and time order by line for the defined period.

The report includes:

  • Task date
  • Task time
  • Task direction (Inbound, Outbound, Internal)
  • From
  • To
  • Task duration
  • Task Channel

e.g. a table as follows, per agent:

DateTimeDirectionChannelSourceDestinationDurationTask Acceptance Time
4/23/138:01:00InboundVoice214-555-1212Sales Call Center0:03:407
4/23/138:05:00InboundSMS972-222-1551Returns Call Center0:02:115

The Task Duration report should display a summary of task duration for each task duration range for the defined period.

  • i.e. define a set of duration ranges along the following lines: <1, 1-2, 2-5, 5-10, 10-20, 20-30, 30-60 and >60min
  • For each range the following statistics should be calculated and displayed in the table:
    • total number of tasks
    • %age of total tasks
    • total duration of tasks

The Task Log reports should provide a chronological list of every task created in the system, and list what happened

The report displays the date task created, time task accepted, time task completed, agent (worker) handled, from, to, duration.

The Daily Traffic report displays a graph of Tasks to analyze busy times. This report is generated in order by date.

The report includes:

  • Date
  • Morning Task count
  • Morning average Task duration
  • Afternoon Task count
  • Afternoon average Task duration
  • Peak hour
  • Peak hour Task count

The Hourly Usage report displays a distribution of tasks across hours of the day for the time period selected. This report displays the time (in hours) and the number of tasks for that hour. This report is generated in ascending order by time.

The Tasks by Day report enables the user to view the number of tasks that were handled and/or abandoned, by day. This report is grouped by Date.

The Tasks by Queue report enables the user to view the number of tasks that were routed through each TaskQueue during the defined period of time. This report is sorted by queue.

Agent Activity State Summary

agent-activity-state-summary page anchor

The Agent Activity State Summary report enables the user to view a summarization of the length of time and percentages that agents have spent in different activity states (offline, available, break, etc).

The Agent Status Detail report enables the user to view a detailed listing of agent status by agent by date. Each time and status is detailed with the duration the agent spent with that status active. This report is grouped by agent.

This report is a summary of all tasks abandoned (task.canceled) for a given period (Hourly, Daily, Weekly).

This reports lists total number of tasks by ingress point into the contact center. It is most commonly used for voice channel, showing for each company number the total number of inbound calls per number.

Short Task Report Summary by Agent

short-task-report-summary-by-agent page anchor

This report lists all calls that were answered by an agent that was connected for less than 5 seconds. This report is sorted by agent and includes total short calls for a given period (Hourly, Daily, Weekly)

Frequent Customer Summary

frequent-customer-summary page anchor

The Frequent Customer Summary report enables the user to view a list of the top 50 customers (task originators) that have repeated tasks.

Purpose: to identify customers with recurring issues (or overusing support)

Reports not available from Twilio Data alone

reports-not-available-from-twilio-data-alone page anchor

Task Disposition Code Summary Report

task-disposition-code-summary-report page anchor
  • Twilio does not currently have a method to associate disposition codes to tasks, and so this should currently be done in a separate database
  • This report lists a summary of all calls associated with each disposition code.

Rate this page: