[Index]
To access the latest documentation, go to Documentation and Resources at: https://voss.portalshape.com
Overview
A computer telephony integration (CTI) route point designates a virtual device that can receive multiple, simultaneous calls for application-controlled redirection.
Add a CTI Route Point
This procedure adds a CTI route point.
Perform these steps:
CTI Route Points Field Reference
Option | Description |
---|---|
Device Name * | Enter a unique identifier for this device, from 1 to 15 characters, including alphanumeric, dot, dash, or underscores. This field is mandatory. |
Description | Enter a descriptive name for the CTI route point. The description can include up to 50 characters in any language, but it cannot include double-quotes ("), percentage sign (%), ampersand (&), back-slash (\), or angle brackets (<>). |
Device Pool * | Choose the name of a Device Pool. The device pool specifies the collection of properties for this device, including Cisco Unified Communications Manager Group, Date Time Group, Region, and Calling Search Space for autoregistration. This field is mandatory. |
Common Device Configuration | Choose the common device configuration to which you want this CTI route point assigned. The common device configuration includes the attributes (services or features) that are associated with a particular user. Configure common device configurations in the Common Device Configuration window. |
Calling Search Space | From the drop-down list, choose a calling search space. The calling search space specifies the collection of partitions that are searched to determine how a collected (originating) number is routed. |
Location * | From the drop-down list, choose the appropriate location for this CTI route point. This field is mandatory. Locations implement call admission control (CAC) in a centralized call-processing system. CAC regulates audio quality and video availability by limiting the amount of bandwidth that is available for audio and video calls between locations. The location specifies the total bandwidth that is available for calls to and from this location. A location setting of Hub_None means that the locations feature does not track the bandwidth that this CTI route point consumes. A location setting of Phantom specifies a location that enables successful CAC across intercluster trunks that use H.323 protocol or SIP. |
User Locale | From the drop-down list, choose the locale that is associated with the CTI route point. The user locale identifies a set of detailed information to support users, including language and font. Note: If no user locale is specified, Cisco Unified CM uses the user locale that is associated with the device pool |
Media Resource Group List | Choose the appropriate Media Resource Group List. A Media Resource Group List is a prioritized grouping of media resource groups. An application chooses the required media resource, such as a Music On Hold server, from the available media resources. The application chooses according to the priority order defined in a Media Resource Group List. If you choose <none>, Cisco Unified CM uses the Media Resource Group that is defined in the device pool. |
Option | Description |
---|---|
Network Hold MOH Audio Source | Choose the audio source that plays when the network starts a hold action. If you do not choose an audio source, Cisco Unified CM uses the audio source that is defined in the device pool. If the device pool does not specify an audio source, the system default is used. |
User Hold MOH Audio Source | Choose the audio source that plays when an application starts a hold action. If you do not choose an audio source, Cisco Unified CM uses the audio source that is defined in the device pool. If the device pool does not specify an audio source, the system default is used. |
Use Trusted Relay Point Required Field * | Enable or disable whether Cisco Unified CM inserts a trusted relay point (TRP) device with this media endpoint. This field is mandatory. Choose one of the following values:
A Trusted Relay Point (TRP) device designates an MTP or transcoder device that is labeled as Trusted Relay Point. |
Calling Party Transformation CSS | This setting allows you to localize the calling party number on the device. Make sure that the Calling Party Transformation CSS that you choose contains the calling party transformation pattern that you want to assign to this device. Tip: Before the call occurs, the device must apply the transformation by using digit analysis. If you configure the Calling Party Transformation CSS as None, the transformation does not match and does not get applied. Ensure that you configure the Calling Party Transformation Pattern in a non-null partition that is not used for routing. |
Geolocation | From the drop-down list box, choose a geolocation. You can choose the Unspecified geolocation, which designates that this device does not associate with a geolocation. |
Use Device Pool Calling Party Transformation CSS | To use the Calling Party Transformation CSS that is configured in the device pool that is assigned to this device, select this check box. If you do not select this check box, the device uses the Calling Party Transformation CSS that you configured in the CTI Route Point Configuration window. |
CTI Route Points Line Field Reference
Field | Description |
---|---|
Directory Number * | Enter a dialable phone number. Values can include route pattern wildcards and numeric characters (0 to 9). Special characters such as a question mark (?), exclamation mark (!), backslash (\), brackets ([ ]), plus sign (+), dash (-), asterisk (*), caret (^), pound sign (#), and an X are also allowable. Special characters that are not allowed are a period (.), at sign (@), dollar sign ($), and percent sign (%). This field is mandatory. At the beginning of the pattern, enter \+ if you want to use the international escape character +. For this field, \+ does not represent a wildcard; instead, entering \+ represents a dialable digit. When saving the CTI route point, the combination of directory number and route partition name displays as a summary header in the Line section. |
Route Partition * | Choose the partition to which the directory number belongs. Make sure that the directory number that you enter in the Directory Number field is unique within the partition that you choose. If you do not want to restrict access to the directory number, choose <None> for the partition. When saving the CTI route point, the combination of directory number and route partition name displays as a summary header in the Line section. |
Index | This field is the line position on the device. If left blank, an integer is automatically assigned. |
External Phone Number Mask | Indicate phone number (or mask) that is used to send Caller ID information when a call is placed from this line. You can enter a maximum of 24 number, the international escape character +, and "X" characters. The Xs represent the directory number and must appear at the end of the pattern. For example, if you specify a mask of 972813XXXX, an external call from extension 1234 displays a caller ID number of 9728131234. |
Line Text Label | Use this field only if you do not want the directory number to show on the line appearance. Enter text that identifies this directory number for a line and phone combination. Suggested entries include boss name, department name, or other appropriate information to identify multiple directory numbers to a secretary or assistant who monitors multiple directory numbers. |
Display (Internal Caller ID) | Leave this field blank to have the system display the extension. Use a maximum of 30 characters. Typically, use the username or the directory number. If using the directory number, the person receiving the call may not see the proper identity of the caller. |
ASCII Display (Caller ID) | This field provides the same information as the Display (Internal Caller ID) field, but limit input to ASCII characters. Devices that do not support Unicode (internationalized) characters display the content of the ASCII Display (Internal Caller ID) field. |
Ring Setting (Phone Active) | If applicable, the ring setting that is used when this phone has another active call on a different line. Choose one of the following options:
|
Field | Description |
---|---|
Ring Setting (Phone Idle) | If applicable, the ring setting for the line appearance when an incoming call is received and no other active calls exist on that device. Choose one of the following options:
|
Recording Option | This field determines the recording option on the line appearance of an agent. The default recording option is Call Recording Disabled. Choose one of the following options:
|
Recording Profile | This field determines the recording profile on the line appearance of an agent. |
Recording Media Source | This field determines the recording media source option on the line appearance. Choose one of the following options:
|
Monitoring Calling Search Space | The monitoring calling search space of the supervisor line appearance must include the agent line or device partition to allow monitoring the agent. |
Visual Message Waiting Indicator Policy | Use this field to configure the handset lamp illumination policy. Choose one of the following options:
|
Audible Message Waiting Indicator Policy | Use this field to configure an audible message waiting indicator policy. Choose one of the following options:
|
Log Missed Calls | If selected, Cisco Unified CM logs missed calls in the call history for the shared line appearance on the phone. |
Field | Description |
---|---|
Busy Trigger | This setting, working with Maximum Number of Calls and Call Forward Busy, determines the maximum call number for the line. Use this field with Maximum Number of Calls for CTI route points. The default specifies 4500 calls |
Maximum Number of Calls | For CTI route points, you can configure up to 10,000 calls for each port. The default specifies 5000 calls. Use this field with the Busy Trigger field. Note: We recommend that you set the maximum number of calls to no more than 200 per route point. This prevents system performance degradation. If the CTI application needs more than 200 calls, we recommend that you configure multiple CTI route points. |
Dialed Number | Select to display original dialed number upon call forward. |
Redirected Number | Select to display the redirected number upon call forward. |
Caller Number | Select to display the caller number upon call forward. |
Caller Name | Select to display the caller name upon call forward. |
End User, User ID | The User ID of a user associated with the line. |
This relation wraps the device/cucm/CtiRoutePoint element.
Title | Description | Details | |||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Use Device Pool Calling Party Transformation CSS | To use the Calling Party Transformation CSS that is configured in the device pool that is assigned to this device, check this check box. If you do not check this check box, the device uses the Calling Party Transformation CSS that you configured in the CTI Route Point Configuration window. Default: True |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Product * | Product ID string. read-only except when creating a device. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Protocol * | Protocol option is read-only,except when creating a device. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Device Name * | Enter unique identifier for this device, from 1 to 15 characters, including alphanumeric, dot, dash, or underscores. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
User Hold MOH Audio Source | To specify the audio source that plays when an application initiates a hold action, click the drop-down arrow and choose an audio source from the list that displays. If you do not choose an audio source, Cisco Unified Communications Manager uses the audio source that is defined in the device pool or the system default if the device pool does not specify an audio source ID. You define audio sources in the Music On Hold Audio Source Configuration window. For access, choose Media Resources > Music On Hold Audio Source. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Lines |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Line | An XLine is an entry in the DeviceNumPlanMap table. The actual directory number is referenced inside the XLine object by the "dirn" or "dirnId" element. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Display Ascii |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Associated Endusers |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Enduser |
|
||||||||||||||||||||||||||||||||||||||||||||||||
User Id * |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Ring Setting | Default: Ring |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Consecutive Ring Setting | Consecutive Rings Setting. Replaces the consective ring setting on IPPhone. Default: Use System Default |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Recording Profile Name |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Index |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Ring Setting Active Pickup Alert | Applicable only for IP Phones Default: Use System Default |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Label |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Recording Media Source | Default: Gateway Preferred |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Max Num Calls | Default: 2 |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Partition Usage | This tag cannot be modified. It can only be specified in the add request. Default: General |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Recording Flag | Default: Call Recording Disabled |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Speed Dial |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Monitoring Css Name |
|
||||||||||||||||||||||||||||||||||||||||||||||||
E164Mask |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Missed Call Logging | Default: True |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Call Info Display |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Dialed Number | Default: True |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Redirected Number |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Caller Number |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Caller Name | Default: True |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Dirn | Only uuid attribute is returned in response |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Pattern * |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Route Partition Name * |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Mwl Policy | Default: Use System Policy |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Ring Setting Idle Pickup Alert | Applicable only for IP Phones Default: Use System Default |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Busy Trigger | Default: 1 |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Audible Mwi | Not applicable for gatewayEndpointAnalogAccess and CiscoCatalyst600024PortFXSGateway Default: Default |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Display |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Protocol Side * | Side information is read-only except when creating a device Default: User |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Use Trusted Relay Point * | From the drop-down list box, enable or disable whether Cisco Unified Communications Manager inserts a trusted relay point (TRP) device with this media endpoint. Choose one of the following values: Default—If you choose this value, the device uses the Use Trusted Relay Point setting from the common device configuration with which this device associates. Off—Choose this value to disable the use of a TRP with this device. This setting overrides the Use Trusted Relay Point setting in the common device configuration with which this device associates. On—Choose this value to enable the use of a TRP with this device. This setting overrides the Use Trusted Relay Point setting in the common device configuration with which this device associates. A Trusted Relay Point (TRP) device designates an MTP or transcoder device that is labeled as Trusted Relay Point. Cisco Unified Communications Manager places the TRP closest to the associated endpoint device if more than one resource is needed for the endpoint (for example, a transcoder or RSVPAgent). If both TRP and MTP are required for the endpoint, TRP gets used as the required MTP. See the Cisco Unified Communications Manager System Guide for details of call behavior. If both TRP and RSVPAgent are needed for the endpoint, Cisco Unified Communications Manager first tries to find an RSVPAgent that can also be used as a TRP. If both TRP and transcoder are needed for the endpoint, Cisco Unified Communications Manager first tries to find a transcoder that is also designated as a TRP. See the Cisco Unified Communications Manager System Guide for a complete discussion of network virtualization and trusted relay points. Default: Default |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Network Hold MOH Audio Source | To specify the audio source that plays when the network initiates a hold action, click the drop-down arrow and choose an audio source from the list that displays. If you do not choose an audio source, Cisco Unified Communications Manager uses the audio source that is defined in the device pool or the system default if the device pool does not specify an audio source ID. You define audio sources in the Music On Hold Audio Source Configuration window. For access, choose Media Resources > Music On Hold Audio Source. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
User Locale | From the drop-down list box, choose the locale that is associated with the CTI route point. The user locale identifies a set of detailed information to support users, including language and font. Cisco Unified Communications Manager makes this field available only for CTI route points that support localization. Note If no user locale is specified, Cisco Unified Communications Manager uses the user locale that is associated with the device pool. Note If the users require that information be displayed (on the phone) in any language other than English, verify that the locale installer is installed before configuring user locale. See the Cisco Unified Communications Manager locale installer that is in the Cisco Unified Communications Operating System Administration Guide. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Calling Search Space | From the drop-down list box, choose a calling search space. The calling search space specifies the collection of partitions that are searched to determine how a collected (originating) number should be routed. You can configure the number of calling search spaces that display in this drop-down list box by using the Max List Box Items enterprise parameter. If more calling search spaces exist than the Max List Box Items enterprise parameter specifies, the Find button displays next to the drop-down list box. Click the Find button to display the Find and List Calling Search Space window, then find and choose a calling search space name. Note To set the maximum list box items, choose System > Enterprise Parameters and choose CCMAdmin Parameters. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Location * | Use locations to implement call admission control (CAC) in a centralized call-processing system. CAC enables you to regulate audio quality and video availability by limiting the amount of bandwidth that is available for audio and video calls over links between locations. The location specifies the total bandwidth that is available for calls to and from this location. From the drop-down list box, choose the appropriate location for this CTI route point. A location setting of Hub_None means that the locations feature does not keep track of the bandwidth that this CTI route point consumes. A location setting of Phantom specifies a location that enables successful CAC across intercluster trunks that use H.323 protocol or SIP. To configure a new location, use the System > Location menu option. For an explanation of location-based CAC across intercluster trunks, see the Cisco Unified Communications Manager System Guide. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Calling Party Transformation CSS | This setting allows you to localize the calling party number on the device. Make sure that the Calling Party Transformation CSS that you choose contains the calling party transformation pattern that you want to assign to this device. Tip Before the call occurs, the device must apply the transformation by using digit analysis. If you configure the Calling Party Transformation CSS as None, the transformation does not match and does not get applied. Ensure that you configure the Calling Party Transformation Pattern in a non-null partition that is not used for routing. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Common Device Configuration | Choose the common device configuration to which you want this CTI route point assigned. The common device configuration includes the attributes (services or features) that are associated with a particular user. Configure common device configurations in the Common Device Configuration window. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Device Pool * | Choose the name of a Device Pool. The device pool specifies the collection of properties for this device, including Cisco Unified Communications Manager Group, Date/Time Group, Region, and Calling Search Space for auto-registration. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Media Resource Group List | Choose the appropriate Media Resource Group List. A Media Resource Group List comprises a prioritized grouping of media resource groups. An application chooses the required media resource, such as a Music On Hold server, from the available media resources according to the priority order that is defined in a Media Resource Group List. If you choose <none>, Cisco Unified Communications Manager uses the Media Resource Group that is defined in the device pool. For more information, see topics related to media resource management in the Cisco Unified Communications Manager System Guide. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Geolocation | From the drop-down list box, choose a geolocation. You can choose the Unspecified geolocation, which designates that this device does not associate with a geolocation. You can also choose a geolocation that has been configured with the System > Geolocation Configuration menu option. For an explanation of geolocations, including configuration details, see the Cisco Unified Communications Manager Features and Services Guide. For an overview and details of how logical partitioning uses geolocations, see the Cisco Unified Communications Manager Features and Services Guide. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Class * | Class ID string. Class information is read-only except when creating a device. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Description | Enter a descriptive name for the CTI route point. The description can include up to 50 characters in any language, but it cannot include double-quotes ("), percentage sign (%), ampersand (&), back-slash (\), or angle brackets (<>). |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Shadow |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Name * |
|