Simultaneous Ring Personal¶

Display user’s simultaneous ring personal¶

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

Retrieve the settings of the Simultaneous Ring Personal service of the user.

Example request:

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

Example response:

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

{
     "active": false,
     "doNotRingIfOnCall": true,
     "simultaneousRingNumber": [
          {
               "phoneNumber": "+3225126777",
               "answerConfirmationRequired": false
          }
     ],
     "criteria": [
          {
               "name": "test",
               "active": true,
               "callsFrom": "All calls",
               "doNotPerformAction": false,
               "fromDnCriteria": {
                    "includeAnonymousCallers": false,
                    "selection": "Any",
                    "phoneNumbers": [],
                    "includeUnavailableCallers": false
               }
          }
     ]
}

Response JSON Object:

active (boolean) – the status of the service.
doNotRingIfOnCall (boolean) – if set, the numbers of the service don’t ring if already on call
simultaneousRingNumber (array) – a list of number objects as defined as Simultaneous Ring Number attributes.
criteria (array) – a list of criteria objects as defined as Criteria in List attributes.

Status Codes:

200 OK – no error
404 Not Found – the service is not assigned to the user

Update a user’s simultaneous ring personal¶

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

Update the settings of the Simultaneous Ring Personal service of the user.

Example request:

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

{
     "active": false,
     "doNotRingIfOnCall": true,
     "simultaneousRingNumber": [
          {
               "phoneNumber": "+3225126777",
               "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:

active (boolean) – the status of the service.
doNotRingIfOnCall (boolean) – if set, the numbers of the service don’t ring if already on call
simultaneousRingNumber (array) – a list of number objects as defined as Simultaneous Ring Number attributes.
criteria (array) – a list of criteria objects as defined as Criteria attributes.

Status Codes:

200 OK – no error
404 Not Found – the service is not assigned to the user
400 Bad Request – error during the update

Display user’s simultaneous ring personal criteria¶

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

Retrieve the settings of the specified Simultaneous Ring Personal’s criteria.

Example request:

GET /api/v1/tenants/foo/groups/foogroup/users/foouser/services/simultaneous_ring_personal/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:

name (string) – see name from Criteria attributes.
active (boolean) – see active from Criteria attributes.
timeSchedule (object) – see timeSchedule from Criteria attributes.
holidaySchedule (object) – see holidaySchedule from Criteria attributes.
fromDnCriteria (object) – a criteria from DN object as defined as Criteria From DN attributes.
doNotPerformAction (boolean) – see doNotPerformAction from Criteria attributes.

Status Codes:

200 OK – no error
404 Not Found – the service is not assigned to the user

Create a user’s simultaneous ring personal criteria¶

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

Create a Simultaneous Ring Personal’s criteria.

Example request:

POST /api/v1/tenants/foo/groups/foogroup/users/foouser/services/simultaneous_ring_personal/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:

name (string) – see name from Criteria attributes (required).
active (boolean) – see active from Criteria attributes.
timeSchedule (object) – see timeSchedule from Criteria attributes.
holidaySchedule (object) – see holidaySchedule from Criteria attributes.
fromDnCriteria (object) – a criteria from DN object as defined as Criteria From DN attributes.
doNotPerformAction (boolean) – see doNotPerformAction from Criteria attributes.

Example response:

HTTP/1.1 200 OK

Response JSON Object:

name (string) – see name from Criteria attributes.
active (boolean) – see active from Criteria attributes.
timeSchedule (object) – see timeSchedule from Criteria attributes.
holidaySchedule (object) – see holidaySchedule from Criteria attributes.
forwardToNumberSelection (string) – see forwardToNumberSelection from Criteria attributes.
forwardToPhoneNumber (string) – see forwardToPhoneNumber from Criteria attributes.
fromDnCriteria (object) – a criteria from DN object as defined as Criteria From DN attributes.
doNotPerformAction (boolean) – see doNotPerformAction from Criteria attributes.

Status Codes:

200 OK – no error
404 Not Found – the service is not assigned to the user
400 Bad Request – error during the update

Update a user’s simultaneous ring personal criteria¶

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

Update the settings of the Simultaneous Ring Personal service of the user.

Example request:

PUT /api/v1/tenants/foo/groups/foogroup/users/foouser/services/simultaneous_ring_personal/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:

name (string) – see name from Criteria attributes.
newName (string) – see newName from Criteria attributes.
active (boolean) – see active from Criteria attributes.
timeSchedule (object) – see timeSchedule from Criteria attributes.
holidaySchedule (object) – see holidaySchedule from Criteria attributes.
fromDnCriteria (object) – a criteria from DN object as defined as Criteria From DN attributes.
doNotPerformAction (boolean) – see doNotPerformAction from Criteria attributes.

Example response:

HTTP/1.1 200 OK

Response JSON Object:

name (string) – see name from Criteria attributes.
active (boolean) – see active from Criteria attributes.
timeSchedule (object) – see timeSchedule from Schedule attributes.
holidaySchedule (object) – see holidaySchedule from Schedule attributes.
fromDnCriteria (object) – a criteria from DN object as defined as Criteria From DN attributes.
doNotPerformAction (boolean) – see doNotPerformAction from Criteria attributes.

Status Codes:

200 OK – no error
404 Not Found – the service is not assigned to the user
400 Bad Request – error during the update

Delete a user’s simultaneous ring personal criteria¶

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

Delete the settings of the specified Simultaneous Ring Personal’s criteria.

Example request:

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

{
     "name": "test"
}

Example response:

HTTP/1.1 200 OK

Response JSON Object:

name (string) – see name from Criteria attributes.

Status Codes:

200 OK – no error
404 Not Found – the service is not assigned to the user
400 Bad Request – error during the deletion

Simultaneous Ring Number attributes¶

Name	Type	Methods				Description
Name	Type	GET	POST	PUT	DELETE	Description
phoneNumber	string	A	R	R	O	The phone number (if configured, empty or absent otherwise) (See Phone Number).
answerConfirmationRequired	boolean	A	O	O	O	If set, the answering party must enter a confirmation digit to complete the call.