Update Feature Code Setting

Update the feature code settings for a tenant.

Request URL

PUT {base_url}/uc-cconfig/api/v1/feature-codes

Request parameters

Headers
Parameter Required Type Description
Authorization Yes String The access token used for authentication.

Format: Bearer {access_token}.
x-tenant-code Yes String The tenant name.
Note: You can obtain tenant name using the Query Tenants interface.
Body parameters
Parameter Required Type Description
digitTimeout No Integer The maximum time the system waits for the next digit input when dialing a feature code.

Unit: milliseconds (ms)
Recording
recordingEnabled No Boolean Whether to enable the call recording feature code.
Valid value:
  • true: Enabled
  • false: Disabled
recordingCode No String The feature code for switching user's call recording status.
Voicemail
voicemailCheckEnabled No Boolean Whether to enable the feature code for checking voicemail messages.
Valid value:
  • true: Enabled
  • false: Disabled
voicemailCheckCode No String The feature code for checking voicemail messages.
voicemailLeaveEnabled No Boolean Whether to enable the feature code for leaving a voicemail.
Valid value:
  • true: Enabled
  • false: Disabled
voicemailLeaveCode No String The feature code for leaving a voicemail on a specified extension.
Call Transfer
transferAttendedEnabled No Boolean Whether to enable the attended transfer feature code.
Valid value:
  • true: Enabled
  • false: Disabled
transferAttendedCode No String The attended transfer feature code.
transferBlindEnabled No Boolean Whether to enable the blind transfer feature code.
Valid value:
  • true: Enabled
  • false: Disabled
transferBlindCode No String The blind transfer feature code.
transferDigitTimeout No Integer

The maximum interval (in seconds) allowed between digits when transferring a call.

If the timeout is reached, the transfer will be canceled and the original call will be resumed.

Valid value: 3 to 8
Call Forwarding
forwardAlwaysOnEnabled No Boolean Whether to enable the Enable "Forward All Calls" feature code.
Valid value:
  • true: Enabled
  • false: Disabled
forwardAlwaysOnCode No String The feature code for Enable "Forward All Calls".
forwardAlwaysOffEnabled No Boolean Whether to enable the Disable "Forward All Calls" feature code.
Valid value:
  • true: Enabled
  • false: Disabled
forwardAlwaysOffCode No String The feature code for Disable "Forward All Calls".
forwardBusyOnEnabled No Boolean Whether to enable the Enable "Forward When Busy" feature code.
Valid value:
  • true: Enabled
  • false: Disabled
forwardBusyOnCode No String The feature code for Enable "Forward When Busy".
forwardBusyOffEnabled No Boolean Whether to enable the Disable "Forward When Busy" feature code.
Valid value:
  • true: Enabled
  • false: Disabled
forwardBusyOffCode No String The feature code for Disable "Forward When Busy".
forwardNoAnswerOnEnabled No Boolean Whether to enable the Enable "Forward No Answer" feature code.
Valid value:
  • true: Enabled
  • false: Disabled
forwardNoAnswerOnCode No String The feature code for Enable "Forward No Answer".
forwardNoAnswerOffEnabled No Boolean Whether to enable the Disable "Forward No Answer" feature code.
Valid value:
  • true: Enabled
  • false: Disabled
forwardNoAnswerOffCode No String The feature code for Disable "Forward No Answer".
Call Pickup
pickupEnabled No Boolean Whether to enable the extension call pickup feature code.
Valid value:
  • true: Enabled
  • false: Disabled
pickupCode No String The extension call pickup feature code.
Call Parking
parkingRandomEnabled No Boolean Whether to enable the system park feature code.
Valid value:
  • true: Enabled
  • false: Disabled
parkingRandomCode No String The system park feature code.
parkingDirectedEnabled No Boolean Whether to enable the directed call parking feature code.
Valid value:
  • true: Enabled
  • false: Disabled
parkingDirectedCode No String The directed call parking feature code.
parkingRange No Object<Parking_Range> The range of parking numbers.
parkingTimeout No Integer The maximum time allowed before a parked call is retrieved.

Unit: Second
parkingTimeoutDestination No Object<Destination> The destination to which the call is routed when the parking timeout is reached.
parkingMoh No String The music played when a call is parked.
Switch Business Hours and Holidays Status
statusSwitchCodePrefixEnabled No Boolean Whether the Business Hours Status Switch Code prefix is enabled.
Valid value:
  • true: Enabled
  • false: Disabled
statusSwitchCodePrefix No String The prefix of the Business Hours Status Switch Code.
statusSwitchPermissionAllUsers No Boolean Whether to allow all users to switch the business hours status.
Valid value:
  • true: Enabled
  • false: Disabled
statusSwitchPermissionUserIds No Array<String> The list of user IDs that can switch the business hours status.
keepStatusAfterSwitching No Boolean Whether to keep the switched status.

Valid value:

  • true: Enabled. The status is kept until the next manual switch.
  • false: Disabled. The status is temporary and automatically resets in next hop of time condition.
Intercom
intercomEnabled No Boolean Whether to enable the intercom feature code.
Valid value:
  • true: Enabled
  • false: Disabled
intercomCode No String The intercom feature code.
Queues
queueLoginEnabled No Boolean Whether to enable the queue login/logout feature code.
Valid value:
  • true: Enabled
  • false: Disabled
queueLoginCode No String The feature code for logging in to or logging out of a queue.
queuePauseEnabled No Boolean Whether to enable the feature code for pausing or resuming queue calls.
Valid value:
  • true: Enabled
  • false: Disabled
queuePauseCode No String The feature code for pausing or resuming receiving calls from a queue.
queueLoginAllEnabled No Boolean Whether to enable the feature code for logging in to all queues.
Valid value:
  • true: Enabled
  • false: Disabled
queueLoginAllCode No String The feature code for logging in to all queues.
queueLogoutAllEnabled No Boolean Whether to enable the feature code for logging out of all queues.
Valid value:
  • true: Enabled
  • false: Disabled
queueLogoutAllCode No String The feature code for logging out of all queues.
queueLoginLastEnabled No Boolean Whether to enable the feature code for logging in to the last queue.
Valid value:
  • true: Enabled
  • false: Disabled
queueLoginLastCode No String The feature code for logging in to the last logged-in queue.
Pause Reason
pauseReasons No Object<Pause_Reason> The list of queue pause reasons.
Destination
Parameter Required Type Description
type No String The type of the destination to which the call is routed when the parking timeout is reached.

Valid value:

  • INITIATOR: Route the call back to the user who parked it.
  • USER: Route the call to a specific user.
  • USER_VOICEMAIL: Route the call to a specific user's voicemail.
  • EXTERNAL_NUMBER: Route the call to an external number.
value No String The specific destination to which the call is routed when the parking timeout is reached.
Note: Whether this parameter is required depends on the value of type.
  • If type is set to USER or USER_VOICEMAIL, specify the unique ID of a specific user.

    You can obtain user ID using the xxx interface.

  • If type is set to EXTERNAL_NUMBER, specify an external number.
prefix No String The outbound call prefix.
Note: This parameter applies only when type is set to EXTERNAL_NUMBER. Specify a prefix that matches an outbound route rule to route the call.
Parking_Range
Parameter Required Type Description
rangeStart No String The start number of the parking range.
rangeEnd No String The end number of the parking range.
PauseReasonList
Parameter Required Type Description
items No Array<Pause_Reason> The list of queue pause reasons.
Pause_Reason
Parameter Required Type Description
featureCode No String The status code of the pause reason.
reason No String The pause reason description.

Response parameters

Parameter Type Description
requestId String The unique ID of the request, which can be used to quickly locate the request.
code String The HTTP status code of the request.
  • 200: Request succeeded.
  • Non-200 value: Request failed.
message String The status message of the request.
detailMessage String The detailed error information.

When the request is successful, this parameter returns empty.
result Object<Feature_Code_Setting> The feature code settings.
Feature_Code_Setting
Parameter Type Description
digitTimeout Integer The maximum time the system waits for the next digit input when dialing a feature code.
Recording
recordingEnabled Boolean Whether the call recording feature code is enabled.
  • true: Enabled
  • false: Disabled
recordingCode String The feature code for switching user's call recording status.
Voicemail
voicemailCheckEnabled Boolean Whether the feature code for checking voicemail messages is enabled.
  • true: Enabled
  • false: Disabled
voicemailCheckCode String The feature code for checking voicemail messages.
voicemailLeaveEnabled Boolean Whether the feature code for leaving a voicemail is enabled.
  • true: Enabled
  • false: Disabled
voicemailLeaveCode String The feature code for leaving a voicemail on a specified extension.
Call Transfer
transferAttendedEnabled Boolean Whether the attended transfer feature code is enabled.
  • true: Enabled
  • false: Disabled
transferAttendedCode String The attended transfer feature code.
transferBlindEnabled Boolean Whether the blind transfer feature code is enabled.
  • true: Enabled
  • false: Disabled
transferBlindCode String The blind transfer feature code.
transferDigitTimeout Integer

The maximum interval (in seconds) allowed between digits when transferring a call.

If the timeout is reached, the transfer will be canceled and the original call will be resumed.
Call Forwarding
forwardAlwaysOnEnabled Boolean Whether the Enable "Forward All Calls" feature code is enabled.
  • true: Enabled
  • false: Disabled
forwardAlwaysOnCode String The feature code for Enable "Forward All Calls".
forwardAlwaysOffEnabled Boolean Whether the Disable "Forward All Calls" feature code is enabled.
  • true: Enabled
  • false: Disabled
forwardAlwaysOffCode String The feature code for Disable "Forward All Calls".
forwardBusyOnEnabled Boolean Whether the Enable "Forward When Busy" feature code is enabled.
  • true: Enabled
  • false: Disabled
forwardBusyOnCode String The feature code for Enable "Forward When Busy".
forwardBusyOffEnabled Boolean Whether the Disable "Forward When Busy" feature code is enabled.
  • true: Enabled
  • false: Disabled
forwardBusyOffCode String The feature code for Disable "Forward When Busy".
forwardNoAnswerOnEnabled Boolean Whether the Enable "Forward No Answer" feature code is enabled.
  • true: Enabled
  • false: Disabled
forwardNoAnswerOnCode String The feature code for Enable "Forward No Answer".
forwardNoAnswerOffEnabled Boolean Whether the Disable "Forward No Answer" feature code is enabled.
  • true: Enabled
  • false: Disabled
forwardNoAnswerOffCode String The feature code for Disable "Forward No Answer".
Call Pickup
pickupEnabled Boolean Whether the extension call pickup feature code is enabled.
  • true: Enabled
  • false: Disabled
pickupCode String The extension call pickup feature code.
Call Parking
parkingRandomEnabled Boolean Whether the system park feature code is enabled.
  • true: Enabled
  • false: Disabled
parkingRandomCode String The system park feature code.
parkingDirectedEnabled Boolean Whether the directed call parking feature code is enabled.
  • true: Enabled
  • false: Disabled
parkingDirectedCode String The directed call parking feature code.
parkingRange Object<Parking_Range> The range of parking numbers.
parkingTimeout Integer The maximum time allowed before a parked call is retrieved.
parkingTimeoutDestination Object<Destination> The destination to which the call is routed when the parking timeout is reached.
parkingMoh String The music played when a call is parked.
Switch Business Hours and Holidays Status
statusSwitchCodePrefixEnabled Boolean Whether the Business Hours Status Switch Code prefix is enabled.
  • true: Enabled
  • false: Disabled
statusSwitchCodePrefix String The prefix of the Business Hours Status Switch Code.
statusSwitchPermissionAllUsers Boolean Whether all users can switch the business hours status.
  • true: All users can switch the business hours status.
  • false: Only specific users can switch the business hours status.
statusSwitchPermissionUserIds Array<String> The list of user IDs that can switch the business hours status.
keepStatusAfterSwitching Boolean Whether to keep the switched status.
  • true: The status is kept until the next manual switch.
  • false: The status is temporary and automatically resets in next hop of time condition.
Intercom
intercomEnabled Boolean Whether the intercom feature code is enabled.
  • true: Enabled
  • false: Disabled
intercomCode String The intercom feature code.
Queues
queueLoginEnabled Boolean Whether the queue login/logout feature code is enabled.
  • true: Enabled
  • false: Disabled
queueLoginCode String The feature code for logging in to or logging out of a queue.
queuePauseEnabled Boolean Whether the feature code for pausing or resuming queue calls is enabled.
  • true: Enabled
  • false: Disabled
queuePauseCode String The feature code for pausing or resuming receiving calls from a queue.
queueLoginAllEnabled Boolean Whether the feature code for logging in to all queues is enabled.
  • true: Enabled
  • false: Disabled
queueLoginAllCode String The feature code for logging in to all queues.
queueLogoutAllEnabled Boolean Whether the feature code for logging out of all queues is enabled.
  • true: Enabled
  • false: Disabled
queueLogoutAllCode String The feature code for logging out of all queues.
queueLoginLastEnabled Boolean Whether the feature code for logging in to the last queue is enabled.
  • true: Enabled
  • false: Disabled
queueLoginLastCode String The feature code for logging in to the last logged-in queue.
Pause Reason
pauseReasons Object<Pause_Reason> The list of queue pause reasons.
Destination
Parameter Type Description
type String The type of the destination to which the call is routed when the parking timeout is reached.
  • INITIATOR: Route the call back to the user who parked it.
  • USER: Route the call to a specific user.
  • USER_VOICEMAIL: Route the call to a specific user's voicemail.
  • EXTERNAL_NUMBER: Route the call to an external number.
value String The specific destination to which the call is routed when the parking timeout is reached.
prefix String The outbound call prefix.
Parking_Range
Parameter Type Description
rangeStart String The start number of the parking range.
rangeEnd String The end number of the parking range.
PauseReasonList
Parameter Type Description
items Array<Pause_Reason> The list of queue pause reasons.
Pause_Reason
Parameter Type Description
id String The unique identifier of the pause reason.
featureCode String The status code of the pause reason.
reason String The pause reason description.

Example

Request example

PUT /uc-cconfig/api/v1/feature-codes HTTP/1.1
Host: api.cn.novoone.com
Authorization: Bearer eyJraWQiOiJyZWdpb24ta2V5LTEiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJkaXN0cmlidXRvcmV4YW1wbGVAb3V0bG9vay5jb20iLCJncmFudF90eXBlIjoib3BlbmFwaSIsImNsaWVudF9leHQiOnsiZGVzY3JpcHRpb24iOiLnrKzkuInmlrnlkIjkvZzkvJnkvLTlupTnlKgiLCJwYXJ0bmVyIjoi56S65L6L5ZCI5L2c5LyZ5Ly0In0sImNsaWVudF90eXBlIjoib3BlbmFwaSIsImV4cCI6MTc4ODQyMTIxNiwiaWF0IjoxNzg4Mzk5NjE2LCJqdGkiOiJhMjk4NTllYy0xM2JiLTQ3YzMtOTY3Zi1lMGI3NTZlMDkxZWUiLCJjbGllbnRfaWQiOiJub3ZvLW9wZW4tcGxhdGZvcm0iLCJ1c2VyX2V4dCI6eyJyb2xlSWRzIjpbM10sInN0eXBlIjoiQURNSU4iLCJ0ZW5hbnRDb2RlIjpudWxsLCJ0eXBlIjoiUF9BQ0NPVU5UIiwidXNlcklkIjozMDc2OTEzNjQ0OTE1OTk4NzIwLCJlbWFpbCI6ImRpc3RyaWJ1dG9yZXhhbXBsZUBvdXRsb29rLmNvbSIsInVzZXJuYW1lIjoiZGlzdHJpYnV0b3JleGFtcGxlQG91dGxvb2suY29tIiwidWNJZCI6MzA3NjkxMzY0NDg5MDgzMjg5Nn19.2DazPFkjhR80Kxm7tjqmBIbXzkEnWE874n13rJ_EpjB_da7W2i3JIuGG-W7rsUwMBZg2XkUIV1KtDm9r9dByH0EN2-S9j6nOxRJD9GN_C-uzMPzfxoT8EtU3a3CkmJ_1Eksgq5nbjwH8zyQBigGlL7CNKsi3e0W_Qhh47OIr4NmywCAA--lonnO3c07_VC8IeJPyJXEV5OTCn1XEwsGPdQ5Rs41vdSwHbCYkGzTkbAc6k51ALx4yJsntDryDfvjxc7sn_9rY-0Paaf8A4rabdyTlUz4JD4Dsd-7AW8ieRzBAG1U1_-fyAQhEFPxIT12vp7QLoiUiMMNTIMtkZVfPpA
Content-Type: application/json
x-tenant-code: jint
{
  "recordingEnabled": false,
  "voicemailLeaveEnabled": true,
  "transferDigitTimeout": 8,
  "forwardNoAnswerEnabled": false
}

Response example

HTTP/1.1 200 OK
{
  "requestId": "434413b6e3b158d5daa26fc80057610d",
  "code": "200",
  "message": "SUCCESS",
  "detailMessage": "",
  "result": {
    "recordingEnabled": false,
    "voicemailCheckCode": "*2",
    "voicemailCheckEnabled": true,
    "voicemailLeaveCode": "*12",
    "voicemailLeaveEnabled": true,
    "transferBlindCode": "*03",
    "transferBlindEnabled": true,
    "transferAttendedCode": "*3",
    "transferAttendedEnabled": true,
    "transferDigitTimeout": 8,
    "forwardAlwaysOnCode": "*31",
    "forwardAlwaysOnEnabled": true,
    "forwardAlwaysOffCode": "*031",
    "forwardAlwaysOffEnabled": true,
    "forwardBusyOnCode": "*32",
    "forwardBusyOnEnabled": true,
    "forwardBusyOffCode": "*032",
    "forwardBusyOffEnabled": true,
    "forwardNoAnswerOnCode": "*33",
    "forwardNoAnswerOnEnabled": true,
    "forwardNoAnswerOffCode": "*033",
    "forwardNoAnswerOffEnabled": true,
    "pickupCode": "*04",
    "pickupEnabled": true,
    "parkingRandomCode": "*5",
    "parkingRandomEnabled": true,
    "parkingDirectedCode": "*05",
    "parkingDirectedEnabled": true,
    "parkingTimeout": 60,
    "parkingTimeoutDestination": {
      "type": "INITIATOR",
      "value": "",
      "prefix": ""
    },
    "intercomCode": "*6",
    "intercomEnabled": true,
    "queueLoginCode": "*7",
    "queueLoginEnabled": true,
    "queuePauseCode": "*07",
    "queuePauseEnabled": true,
    "queueLoginAllCode": "*77",
    "queueLoginAllEnabled": true,
    "queueLogoutAllCode": "*077",
    "queueLogoutAllEnabled": true,
    "queueLoginLastCode": "*78",
    "queueLoginLastEnabled": true,
    "digitTimeout": 4000,
    "pauseReasons": {
      "items": [
        {
          "id": "338556457263144960",
          "featureCode": "*01",
          "reason": "Lunch"
        },
        {
          "id": "338556457267339264",
          "featureCode": "*02",
          "reason": "Break"
        },
        {
          "id": "338556457267339265",
          "featureCode": "*03",
          "reason": "Wrap-up"
        }
      ]
    },
    "parkingRange": {
      "rangeStart": "6000",
      "rangeEnd": "6099"
    },
    "parkingMoh": "follow_system",
    "statusSwitchCodePrefix": "*99",
    "statusSwitchCodePrefixEnabled": true,
    "statusSwitchPermissionAllUsers": false,
    "statusSwitchPermissionUserIds": [],
    "keepStatusAfterSwitching": false
  }
}