Get an IVR

Retrieve the details of an IVR.

Request URL

GET {base_url}/uc-cconfig/api/v1/ivrs/{id}

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.

Path parameters


Parameter	Required	Type	Description
id	Yes	String	The ID of the IVR to retrieve. Note: You can obtain the ID using the Search IVRs interface.

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<IVR>	The details of the IVR.

IVR


Parameter	Type	Description
id	String	The unique identifier of the IVR.
extension	String	The extension number of the IVR.
name	String	The name of the IVR.
joinAnnouncement	String	The prompt played when a caller enters the IVR.
repeatAnnouncements	Array<String>	The prompt played to remind callers of the available IVR options when no input is received within the response timeout.
maxTimeout	Integer	The maximum number of times the `repeatAnnouncements` can be played when no input is received within the configured `responseTimeout`.
responseTimeout	Integer	The number of seconds the system waits for caller input after playing the `joinAnnouncement` or `repeatAnnouncements`.
interDigitTimeout	Integer	The number of seconds the system waits for the caller to enter the next digit.
alertInfo	String	The alert-info text added to the Alert-Info header of INVITE requests to trigger IP phones to play a specific ringtone when receiving an IVR call.
dialUser	Object<User_List>	The configuration for allowing callers to reach internal users through the IVR.
dialCallFeature	Object<Call_Feature_List>	The configuration for allowing callers to reach ring groups or queues through the IVR.
dialOutboundRoutes	Object<Outbound_Route_List>	The configuration for allowing callers to reach external numbers through outbound routes via the IVR.
keyPressEvents	Object<Keypress_List>	The configuration for keypress events.
timeoutDestination	Object<Destination>	The destination to route the call when the caller does not provide any input after `maxTimeout` is reached.
invalidDestination	Object<Destination>	The destination to route the call when the caller enters a digit that is not defined in the IVR menu.
timeBasedRoutingEnabled	Boolean	Whether time-based routing is enabled. `true`: Enabled `false`: Disabled
timeBasedRoutingProfileId	String	The ID of the business hours profile associated with time-based routing.
timeBasedRoutingConfig	Object<Time_Based_Routing>	The time-based routing configuration.
directDidNumbers	Array<Direct_DID_List>	The DID numbers associated with the IVR.

User_List


Parameter	Type	Description
enabled	Boolean	Whether direct dialing to internal users is enabled.
mode	String	The direct dialing mode. `ALL`: Allow callers to reach all users. `ALLOWED`: Allow callers to reach only the specified users. `RESTRICTED`: Allow callers to reach all users except the specified users. `DISABLED`: Direct dialing is disabled.
userIds	Object<User_ID>	The IDs of internal users. Note: This parameter is returned only when `mode` is `ALLOWED` or `RESTRICTED`.

User_ID


Parameter	Type	Description
values	Array<String>	The list of internal user IDs.

Call_Feature_List


Parameter	Type	Description
enabled	Boolean	Whether callers can reach ring groups or queues through the IVR. `true`: Enabled `false`: Disabled
items	Object<Call_Feature_Items>	The ring groups or queues that callers can reach through the IVR.

Call_Feature_Items


Parameter	Type	Description
values	Array<Call_Feature_Item>	The ring groups or queues that callers can reach through the IVR.

Call_Feature_Item


Parameter	Type	Description
type	String	The type of call feature. `FEATURE_RING_GROUP`: Ring Group `FEATURE_QUEUE`: Queue
value	String	The ID of the ring group or queue.

Outbound_Route_List


Parameter	Type	Description
enabled	Boolean	Whether callers can reach external numbers through outbound routes via the IVR.
routeIds	Object<Outbound_Route_Item>	The outbound routes that callers can use to reach external numbers through the IVR.

Outbound_Route_Item


Parameter	Type	Description
values	Array<String>	The list of outbound route IDs.

Keypress_List


Parameter	Type	Description
`{keypress}`	String	The key pressed by the caller.
`{destination}`	Object<Destination>	The destination for calls when the caller presses the specified key.

Time_Based_Routing_Config


Parameter	Type	Description
holidayHandling	String	The holiday handling mode. `route`: Route IVR calls during holidays to a specific destination. `ignore`: Ignore holidays and route calls according to the business hours settings.
outsideDestination	Object<Destination>	The destination for IVR calls received outside business hours.
holidayDestination	Object<Destination>	The destination for IVR calls received during holidays.

Destination


Parameter	Type	Description
type	String	The destination type. `USER` `USER_VOICEMAIL` `IVR` `RING_GROUP` `QUEUE` `EXTERNAL_NUMBER` `HANGUP` `PLAY_PROMPT`: Play the prompt and hang up. `PLAY_PROMPT_RETURN_IVR`: Play the prompt and return to the IVR. `PLAY_IVR_PROMPT`: Play the IVR prompt and return to the IVR.
value	String	The destination value.
prefix	String	The dial-out prefix.
turnOffRecording	Boolean	Whether call recording is disabled.
repeatCount	Integer	The number of times to play the prompt when `type` is `PLAY_PROMPT` or `PLAY_PROMPT_RETURN_IVR`.

Direct_DID_List


Parameter	Type	Description
id	String	The unique identifier of the DID number.
number	String	The DID number.
name	String	The DID name.

Example

Request example

GET /uc-cconfig/api/v1/ivrs/363581284498870272 HTTP/1.1
Host: api.cn.novoone.com
Authorization: Bearer eyJraWQiOiJjbi0wLWtleS0xIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiJkaXN0cmlidXRvcmV4YW1wbGVAb3V0bG9vay5jb20iLCJncmFudF90eXBlIjoib3BlbmFwaSIsImNsaWVudF9leHQiOnsiZGVzY3JpcHRpb24iOiLnrKzkuInmlrnlkIjkvZzkvJnkvLTlupTnlKgiLCJwYXJ0bmVyIjoi56S65L6L5ZCI5L2c5LyZ5Ly0In0sImNsaWVudF90eXBlIjoib3BlbmFwaSIsImV4cCI6MTc5MDc3Mzc4NSwiaWF0IjoxNzkwNzUyMTg1LCJqdGkiOiI0ZDkyZTY1Mi00ZGY3LTQ1YzEtYTEyMy1lM2M4NTQ1NzU3MGQiLCJjbGllbnRfaWQiOiJub3ZvLW9wZW4tcGxhdGZvcm0iLCJ1c2VyX2V4dCI6eyJyb2xlSWRzIjpbM10sInN0eXBlIjoiQURNSU4iLCJ0ZW5hbnRDb2RlIjpudWxsLCJ0eXBlIjoiUF9BQ0NPVU5UIiwidXNlcklkIjozMDc2OTEzNjQ0OTE1OTk4NzIwLCJlbWFpbCI6ImRpc3RyaWJ1dG9yZXhhbXBsZUBvdXRsb29rLmNvbSIsInVzZXJuYW1lIjoiZGlzdHJpYnV0b3JleGFtcGxlQG91dGxvb2suY29tIiwidWNJZCI6MzA3NjkxMzY0NDg5MDgzMjg5Nn19.QuOwtCNqOWcSHwH2n1MaDIrkJWnidV11bgrBfvTueqDahurTqkEKPRZRDEIkx41NbK65gDZOtGZRPkD1k9riERFobWiYcUBfHiAsc_inLBf41PXXltIV0awmHvG7wYdjpqWttPNrwB81mZJB40DzIPBIif7HvZcv_gqrxd4A_oVxGOGM2xqFwJQe8fkhNWTfcUH143hqpT7NNU7dDTFAGxLckQohu5POfzSMXZeJD0BQ7T4M9KihkmKUQegW5PwiroxzHa1-0bplkJOYN37uRXOAMal6f9viVJc_zdY9nkXqeq7wNvawlFookB4S-jpBTEPmw3v6wfdoXqLYRNlD2A
x-tenant-code: jint

Response example

HTTP/1.1 200 OK
{
  "requestId": "51fc7d7e7ef2ecf1921e48799a99a799",
  "code": "200",
  "message": "SUCCESS",
  "detailMessage": "",
  "result": {
    "id": "363581284498870272",
    "extension": "6201",
    "name": "zz-test-ivr",
    "joinAnnouncement": "default",
    "repeatAnnouncements": ["default"],
    "maxTimeout": 3,
    "responseTimeout": 5,
    "interDigitTimeout": 3,
    "alertInfo": "",
    "dialUser": {
      "enabled": false,
      "mode": "ALL"
    },
    "dialCallFeature": {
      "enabled": false
    },
    "dialOutboundRoutes": {
      "enabled": false
    },
    
    "keyPressEvents": {},
    "timeoutDestination": {
      "type": "HANGUP",
      "value": "",
      "prefix": "",
      "turnOffRecording": false,
      "repeatCount": 0
    },
    "invalidDestination": {
      "type": "PLAY_IVR_PROMPT",
      "value": "",
      "prefix": "",
      "turnOffRecording": false,
      "repeatCount": 0
    },
    "timeBasedRoutingEnabled": false,
    "timeBasedRoutingProfileId": "",
    "timeBasedRoutingConfig": null,
    "directDidNumbers": []
  }
}