Batch dispositions modification

Modify multiple dispositions in batch mode within a project.

Request
Method PUT
Resource https://[customer].asp.virtual-call-center.eu/v2/projects/[projectid]/records/dispositions
Options N/A
Body Disposition objects, encoded in JSON.
Response
Body Array of partial results by elements.

Request

Resource parameters

Name Type Mandatory Comment
customer string yes Your call centre’s unique identifier (subdomain).
projectid integer yes Unique project identifier.

Request object

Name Type Mandatory Comment
avoid_in_call bool no Ignores all records being handled by agents (prework, in call, afterwork).
disposition object no Key value pairs that should be set for every record, specified by an ‘element’ object.
elements array of objects yes Array of disposition objects to be set.

Element object

Name Type Mandatory Comment
description string no Description added by the supervisor.
dispositionid string no Unique disposition identifier.
next_calldate string no Defines callback time in YYYY-MM-DD HH:MM:SS format.
numberid string yes/no Unique record identifier specifying a record to be set. Either ‘search’ or ‘numberid’ can be set.
search object yes/no Specifies a record to which key value pairs should be applied to. Either ‘search’ or ‘numberid’ can be set. Possible values:
– numberid: Unique record identifier.
– pref_userid: User identifier to whom the disposition is linked.
– act_status: Disposition identifier which the disposition is linked.

If more than one ‘search’ object is added, the search method will be ‘OR’. If more than one search criteria is defined within the ‘search’ object, the search method will be ‘AND’.

userid string no User identifier to whom the disposition is linked.

Disposition object

Name Type Mandatory Comment
description string no Description added by the supervisor.
dispositionid integer no Unique disposition identifier.
next_calldate string no Defines callback time in YYYY-MM-DD HH:MM:SS format.
userid integer no User identifier to whom the disposition is linked.

Response

Array of partial results by elements.

Example

URL: https://mycc.asp.virtual-call-center.eu/v2/projects/17/records/dispositions

Request body

{
    "elements": [
        {
            "numberid": "1",
            "dispositionid": "1",
            "userid": "22",
            "next_calldate": "2017-10-10 11:00:00",
            "description": "High school graduate"
        },
        {
            "search": {
                "name": "Green"
            }
        }
    ],
    "disposition": {
        "dispositionid": "2",
        "userid": "7",
        "next_calldate": "2017-09-10 12:00:00",
        "description": "University degree"
    },
    "avoid_in_call": true
}

Response body

{
    "errors": [],
    "response": {
        "0": true,
        "1": true
    }
}

Response body if partially successful

{
    "errors": [
        {
            "errorcode": 417,
            "errormessage": "error.missing_numberid_or_search",
            "index": 1
        }
    ],
    "response": {
        "0": true,
        "2": true
    }
}

There are no comments yet.

Comment

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.