Sequential Ring

Display user’s sequential ring

GET /api/v1/tenants/(string: tenant_id)/groups/(string: group_id)/users/(string: user_id)/services/sequential_ring/

Retrieve the settings of the Sequential Ring service of the user.

Example request:

GET /api/v1/tenants/foo/groups/foogroup/users/foouser/services/sequential_ring/ HTTP/1.1
Host: example.com

Example response:

HTTP/1.1 200 OK
Content-Type: "application/json"

{
     "ringBaseLocationFirst": true,
     "baseLocationNumberOfRings": 3,
     "continueIfBaseLocationIsBusy": true,
     "callerMayStopSearch": false,
     "locations": [
          {
               "id": 1,
               "phoneNumber": "+3225126777",
               "numberOfRings": 5,
               "answerConfirmationRequired": false
          }
     ],
     "criteria": [
          {
               "name": "test",
               "active": true,
               "callsFrom": "All calls",
               "doNotPerformAction": false,
               "fromDnCriteria": {
                    "includeAnonymousCallers": false,
                    "selection": "Any",
                    "phoneNumbers": [],
                    "includeUnavailableCallers": false
               }
          }
     ]
}
Response JSON Object:

  • ringBaseLocationFirst (boolean) – if set, the service rings the base location.

  • baseLocationNumberOfRings (integer) – the number of rings to be played.

  • continueIfBaseLocationIsBusy (boolean) – if set, the service continues to search if unable to alert the location.

  • callerMayStopSearch (boolean) – if set, the caller end the Sequential Rig service.

  • locations (array) – a list of location objects as defined as Location attributes.

  • criteria (array) – a list of criteria objects as defined as Criteria in List attributes.

Status Codes:

Update a user’s sequential ring

PUT /api/v1/tenants/(string: tenant_id)/groups/(string: group_id)/users/(string: user_id)/services/sequential_ring/

Update the settings of the Sequential Ring service of the user.

Example request:

PUT /api/v1/tenants/foo/groups/foogroup/users/foouser/services/sequential_ring/ HTTP/1.1
Host: example.com
Content-Type: "application/json"

{
     "ringBaseLocationFirst": false,
     "baseLocationNumberOfRings": 8,
     "continueIfBaseLocationIsBusy": true,
     "callerMayStopSearch": false,
     "locations": [
          {
               "id": 1,
               "delete": true
          },
          {
               "id": 2,
               "phoneNumber": "+3225126777",
               "numberOfRings": 5,
               "answerConfirmationRequired": false
          }
     ],
     "criteria": [
          {
               "name": "test",
               "active": true
          },
          {
               "name": "test2",
               "active": false,
               "callsFrom": "All calls",
               "doNotPerformAction": false,
               "fromDnCriteria": {
                    "includeAnonymousCallers": false,
                    "selection": "Any",
                    "phoneNumbers": [],
                    "includeUnavailableCallers": false
               }
          },
          {
               "name": "test3",
               "delete": true
          }
     ]
}

Example response:

HTTP/1.1 200 OK
Request JSON Object:

  • ringBaseLocationFirst (boolean) – if set, the service rings the base location.

  • baseLocationNumberOfRings (integer) – the number of rings to be played.

  • continueIfBaseLocationIsBusy (boolean) – if set, the service continues to search if unable to alert the location.

  • callerMayStopSearch (boolean) – if set, the caller end the Sequential Rig service.

  • locations (array) – a list of location objects as defined as Location attributes.

  • criteria (array) – a list of criteria objects as defined as Criteria attributes.

Status Codes:

Display user’s sequential ring criteria

GET /api/v1/tenants/(string: tenant_id)/groups/(string: group_id)/users/(string: user_id)/services/sequential_ring/criteria/(string: instance_name)/

Retrieve the settings of the specified Sequential Ring’s criteria.

Example request:

GET /api/v1/tenants/foo/groups/foogroup/users/foouser/services/sequential_ring/criteria/foocriteria/ HTTP/1.1
Host: example.com

Example response:

HTTP/1.1 200 OK
Content-Type: "application/json"

{
     "name": "test",
     "active": true,
     "timeSchedule": {
          "level": "User",
          "name": "Every Friday",
          "type": "Time"
     },
     "holidaySchedule": {
          "level": "User",
          "name": "Every Easter",
          "type": "Holiday"
     },
     "fromDnCriteria": {
          "selection": "Any",
          "includeAnonymousCallers": false,
          "includeUnavailableCallers": true,
          "phoneNumbers": [
               "+3225126777"
          ]
     },
     "doNotPerformAction": false
}
Response JSON Object:
Status Codes:

Create a user’s sequential ring criteria

POST /api/v1/tenants/(string: tenant_id)/groups/(string: group_id)/users/(string: user_id)/services/sequential_ring/criteria/

Create a new Sequential Ring’s criteria.

Example request:

POST /api/v1/tenants/foo/groups/foogroup/users/foouser/services/sequential_ring/criteria/ HTTP/1.1
Host: example.com
Content-Type: "application/json"

{
     "name": "test",
     "active": true,
     "timeSchedule": {
          "level": "User",
          "name": "Every Friday",
          "type": "Time"
     },
     "holidaySchedule": {
          "level": "User",
          "name": "Every Easter",
          "type": "Holiday"
     },
     "fromDnCriteria": {
          "selection": "Any"
          "includeAnonymousCallers": false,
          "includeUnavailableCallers": true,
          "phoneNumbers": [
               "+3225126777"
          ]
     }
}
Request JSON Object:

Example response:

HTTP/1.1 200 OK
Response JSON Object:
Status Codes:

Update a user’s sequential ring criteria

PUT /api/v1/tenants/(string: tenant_id)/groups/(string: group_id)/users/(string: user_id)/services/sequential_ring/criteria/(string: instance_name)/

Update the settings of the Sequential Ring service of the user.

Example request:

PUT /api/v1/tenants/foo/groups/foogroup/users/foouser/services/sequential_ring/criteria/foocriteria/ HTTP/1.1
Host: example.com
Content-Type: "application/json"

{
     "name": "test",
     "newName": "test_new",
     "active": true,
     "timeSchedule": {
          "level": "User",
          "name": "Every Friday",
          "type": "Time"
     },
     "holidaySchedule": {
          "level": "User",
          "name": "Every Easter",
          "type": "Holiday"
     },
     "fromDnCriteria": {
          "selection": "Any"
          "includeAnonymousCallers": false,
          "includeUnavailableCallers": true,
          "phoneNumbers": [
               "+3225126777"
          ]
     }
}
Request JSON Object:

Example response:

HTTP/1.1 200 OK
Response JSON Object:
Status Codes:

Delete a user’s sequential ring criteria

DELETE /api/v1/tenants/(string: tenant_id)/groups/(string: group_id)/users/(string: user_id)/services/sequential_ring/criteria/(string: instance_name)/

Delete the specified Sequential Ring’s criteria.

Example request:

DELETE /api/v1/tenants/foo/groups/foogroup/users/foouser/services/sequential_ring/criteria/foocriteria/ HTTP/1.1
Host: example.com
Content-Type: "application/json"

{
     "name": "test"
}

Example response:

HTTP/1.1 200 OK
Response JSON Object:
Status Codes: