User state log

Reading Time: 2 minutes

Retrieve user state log, filtered according to given options.

Request
Method GET
Resource https://[customer].asp.virtual-call-center.eu/v2/statistics/userstate
Options from, to, projects, users, of
Body N/A
Response
Body Requested user states in tabulator-tabbed, CSV or JSON format.

Request

Resource parameters

Options

Name Type Mandatory Comment
customer string yes Your call centre’s unique identifier (subdomain).
from string yes First date of the requested time period to be searched, in yyyymmdd format (e.g: from=20120301).
of string no Output format. Possible values:
– json (default)
– tab
– csv
projects integer no From which specific project(s) should data be retrieved. If there are several items, they should be separated with commas. (e.g: projects=53,64).
to string yes Last date of the requested time period to be searched, in yyyymmdd format (e.g: from=20120331).
users integer no Which user(s) data should be retrieved. If there are several items, they should be separated with commas. (e.g: users=13,14,15).

Response

Response object

Name Type Comment
auxid integer Auxiliary codes connected with breaks from work.
duration integer Time spent in ‘state’.
name integer Name of the user.
numberid integer Record’s identifier for the caller.
prevstate string Previous status.
prevtime integer Timestamp when entering ‘prevstate’, in ‘YYYY-MM-DD hh:mm:ss’ format.
projectid integer Project identifier.
state string Actual status. Possible values:
– OFFLINE
– UNAVAILABLE
– AVAILABLE
– PREWORK
– WAITING4CALL
– WAITING4RECALL
– RINGING
– CALL
– HOLD
– AFTERWORK
– AUX
time integer Timestamp when entering ‘state’, in ‘YYYY-MM-DD hh:mm:ss’ format.
userid integer User identifier.
username integer User’s username.

Example

List the states of Robert Green (userid=6) on 20.02.2013.

https://mycc.asp.virtual-call-center.eu/v2/statistics/userstate?from=20130220&to=20130220&users=6

Response body

{
    "response": [
        {
            "userid": 6,
            "prevstate": "OFFLINE",
            "state": "UNAVAILABLE",
            "prevtime": "2013-02-20 15:40:06",
            "time": "2013-02-20 15:40:06",
            "projectid": 0,
            "numberid": 0,
            "auxid": null,
            "duration": 0,
            "username": "green_op",
            "name": "Robert Green"
        },
        {
            "userid": 6,
            "prevstate": "UNAVAILABLE",
            "state": "AVAILABLE",
            "prevtime": "2013-02-20 15:40:06",
            "time": "2013-02-20 15:40:11",
            "projectid": 0,
            "numberid": 0,
            "auxid": null,
            "duration": 5.75,
            "username": "green_op",
            "name": "Robert Green"
        },
        {
            "userid": 6,
            "prevstate": "AVAILABLE",
            "state": "AUX",
            "prevtime": "2013-02-20 15:40:11",
            "time": "2013-02-20 15:40:19",
            "projectid": 1,
            "numberid": 0,
            "auxid": null,
            "duration": 7.44,
            "username": "green_op",
            "name": "Robert Green"
        },
        {
            "userid": 6,
            "prevstate": "AUX",
            "state": "AVAILABLE",
            "prevtime": "2013-02-20 15:40:19",
            "time": "2013-02-20 15:41:05",
            "projectid": 1,
            "numberid": 0,
            "auxid": "lunch",
            "duration": 46.4,
            "username": "green_op",
            "name": "Robert Green"
        },
        {
            "userid": 6,
            "prevstate": "AVAILABLE",
            "state": "WAITING4CALL",
            "prevtime": "2013-02-20 15:41:05",
            "time": "2013-02-20 15:41:12",
            "projectid": 1,
            "numberid": 0,
            "auxid": null,
            "duration": 6.96,
            "username": "green_op",
            "name": "Robert Green"
        },
        {
            "userid": 6,
            "prevstate": "WAITING4CALL",
            "state": "RINGING",
            "prevtime": "2013-02-20 15:41:12",
            "time": "2013-02-20 15:41:17",
            "projectid": 1,
            "numberid": 2,
            "auxid": null,
            "duration": 4.57,
            "username": "green_op",
            "name": "Robert Green"
        },
        {
            "userid": 6,
            "prevstate": "RINGING",
            "state": "AFTERWORK",
            "prevtime": "2013-02-20 15:41:17",
            "time": "2013-02-20 15:41:25",
            "projectid": 1,
            "numberid": 2,
            "auxid": null,
            "duration": 7.88,
            "username": "green_op",
            "name": "Robert Green"
        }
    ],
    "errors": []
}

There are no comments yet.
Subscribe to our newsletter
or Contact us!
Please note that by subscribing to our newsletter, you agree to receive regular email messages from VCC Live® about service related news and updates. By subscribing to our newsletter, you also agree that VCC Live® will use your data in accordance with the applicable Privacy Policy until you unsubscribe from the newsletter.