Reports: chats per operator

Authentication

LibraryH3lp supports cookie-based authentication. To learn more, you can read the details on authentication.

HTTP and HTTPS

Requests are served over HTTPS. To ensure data privacy, unencrypted HTTP is not supported.

URI

/2011-12-03/reports/chats-per-operator

HTTP GET

Returns comma-separated operator chat statistics over a given time period and for the desired queues. The header for the comma-separated values looks like: operator, n, mean, median, min, max. Each entry post-header contains the number of chats per operator, the mean wait time in seconds before a chat was answered (total wait time / number of chats), the median wait time in seconds before a chat was answered, the minimum wait time in seconds before a chat was answered, and the maximum wait time in seconds before a chat was answered for the given operator.

Optional parameters

You may GET the following parameters:

Parameters Description
format If set to "csv", then a CSV file named "chats-per-hour.csv" containing the chats per hour data will be returned.
queues A comma-separated list of queue IDs from which report data should be generated. If not specified, all queues are used by default.
start The start date of the report. Format is YYYY-MM-DD. If not specified, then the start date is the beginning of time.
end The end date of the report. Format is YYYY-MM-DD. If not specified, the end date is today.
sysmsg Boolean. If true, any chats originating from automated systems rather than a person will be included. If null or not specified, chats originating from automated systems will be ignored. This option is particularly handy when running reports on gateway chats.
notanswered Boolean. If true, any chats that were not answered by an operator will be included. If null or not specified, chats that were not answered by an operator will be ignored.
duration An integer number of seconds for the minimum chat duration. Any chats whose duration is less than this value will be ignored. If not provided, chats of any duration will be included.
timezone String containing a time zone to use for chat time stamps. Read more about time zones within LibraryH3lp.

Example

GET /2011-12-03/reports/chats-per-operator

operator,n,mean,median,min,max example-operator1,1741,69424/1741,13,2,2170
example-operator2,946,6422/473,10,3,212
example-operator3,952,40711/952,32,5,558
example-operator4,679,15245/679,17,5,284
example-operator5,3317,71313/3317,12,1,2647
example-operator6,658,4134/329,8,0,358
example-operator7,601,43889/601,18,3,11229
example-operator8,565,18828/565,24,3,365
example-operator9,1054,79545/1054,28,5,3681
example-operator10,1446,40517/482,55/2,0,4251
example-operator11,4564,68776/1141,15,2,4196
example-operator12,548,22581/274,35/2,2,4400

HTTP POST

Not supported.

HTTP PUT

Not supported.

HTTP DELETE

Not supported.