Cisco Unified Communications Manager (Unified CM) is the powerful call-processing component of the Cisco Unified Communications Solution. It is a scalable, distributable, and highly available enterprise IP telephony call-processing solution. Unified CM acts as the platform for collaborative communication and as such supports a wide array of features. In order to provision, invoke the features, monitor, and control such a powerful system, Unified CM supports different interface types.
This chapter gives an introduction to the different interfaces of Unified CM and includes the following sections:
•Cisco Unified Communications Manager Interfaces
•What is New in Cisco Unified Communications Manager 8.5(1) API
Cisco Unified Communications Manager Interfaces
The interface types supported by Unified CM are divided into the following types:
•Device Monitoring and Call Control Interfaces
•Routing Rules Interface
The following are the provisioning interfaces of Unified CM:
•Cisco Extension Mobility service
The Administration XML (AXL) API provides a mechanism for inserting, retrieving, updating and removing data from the Unified CM configuration database using an eXtensible Markup Language (XML) Simple Object Access Protocol (SOAP) interface. This allows a programmer to access Unified CM provisioning services using XML and exchange data in XML form, instead of using a binary library or DLL. The AXL methods, referred to as requests, are performed using a combination of HTTP and SOAP. SOAP is an XML remote procedure call protocol. Users perform requests by sending XML data to the Unified CM Publisher server. The publisher then returns the AXL response, which is also a SOAP message.
This guide gives detailed information on the AXL API see Part 1, Administrative XML Programming.
For more information, see the Administrative XML Tech Center on the Cisco Developer Network at http://developer.cisco.com/web/axl/home
Cisco Extension Mobility
The Cisco Extension Mobility (Extension Mobility) service, a feature of Unified CM, allows a device, usually a Cisco Unified IP Phone, to temporarily embody a new device profile, including lines, speed dials, and services. It enables users to temporarily access their individual Cisco Unified IP Phone configuration, such as their line appearances, services, and speed dials, from other Cisco Unified IP Phones. The Extension Mobility service works by downloading a new configuration file to the phone. Unified CM dynamically generates this new configuration file based on information about the user who is logging in. You can use the XML-based Extension Mobility service API with your applications, so they can take advantage of Extension Mobility service functionality.
This guide gives detailed information on the Extension Mobility APIs, see Part 3, Cisco Extension Mobility Service API.
For more information, see the Extension Mobility API Tech Center on the Cisco Developer Network at http://developer.cisco.com/web/emapi/home
Device Monitoring and Call Control Interfaces
The following are the device monitoring and call control interfaces of Unified CM:
•Cisco TAPI and Wave Driver
•Cisco Web Dialer
Cisco TAPI and Wave Driver
Unified CM exposes sophisticated call control of IP telephony devices and soft-clients via the Computer Telephony TAPI interface. Cisco's Telephone Service Provider (TSP) and Wave Driver interface enables custom applications to monitor telephony-enabled devices and call events, establish first- and third-party call control, and interact with the media layer to terminate media, play announcements, record calls.
Information on Cisco TAPI and Wave Driver is beyond the scope of this guide. For information of Cisco TAPI and Wave Driver, see Cisco Unified TAPI Developers Guide for Cisco Unified Communications Manager for relevant release of Unified CM at the following location:
For more information, see the TAPI and Wave Driver Tech Center on the Cisco Developer Network at http://developer.cisco.com/web/tapi/home
Unified CM exposes sophisticated call control of IP telephony devices and soft-clients via the Computer Telephony JTAPI interface. Cisco's JTAPI enables custom applications to monitor telephony-enabled devices and call events, as well as establish first- and third-party call control.
Information on Cisco JTAPI is beyond the scope of this guide. For information on Cisco JTAPI, see Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager for relevant release of Unified CM at the following location:
For more information, see the JTAPI Tech Center on the Cisco Developer Network at http://developer.cisco.com/web/jtapi/home
Cisco Web Dialer
The Web Dialer, which is installed on a Unified CM server, allows Cisco Unified IP Phone users to make calls from web and desktop applications. For example, the Web Dialer uses hyper linked telephone numbers in a company directory to allow users to make calls from a web page by clicking the telephone number of the person that they are trying to call. The two main components of Web Dialer comprise the Web Dialer Servlet and the Redirector Servlet.
This guide gives detailed information on the Web Dialer API, see Part 4, Cisco Web Dialer API Programming.
For more information, see the Web Dialer Tech Center on the Cisco Developer Network at http://developer.cisco.com/web/wd/home
The following are the serviceability interfaces of Unified CM:
A collection of services and tools designed to monitor, diagnose, and address issues specific to Unified CM. Serviceabiltiy XML interface:
•Provides platform, service and application performance counters to monitor the health of Unified CM hardware and software
•Provides real-time device and CTI connection status to monitor the health of phones, devices, and applications connected to Unified CM.
•Enables remote control (Start/Stop/Restart) of Unified CM services.
•Collects and packages Unified CM trace files and logs for troubleshooting and analysis.
•Provides applications with Call Detail Record files based on search criteria.
•Provides management consoles with SNMP data specific to Unified CM hardware and software.
This guide gives detailed information on the Serviceability XML APIs, see Part 2, Serviceability XML Programming.
For more information, see the Serviceability XML Tech Center on the Cisco Developer Network at http://developer.cisco.com/web/sxml/home
SNMP interface allows external applications to query and report various Unified CM entities. It provides information on the connectivity of the Unified Communication Manager to other devices in the network, including syslog information.
The MIBs supported by Unified CM includes:
•Cisco-CCM-MIB, CISCO-CDP-MIB, Cisco-syslog-MIB
•Standard MIBs like MIB II, SYSAPPL-MIB, HOST RESOURCES-MIB
For more information, see the SNMP/MIB Tech Center on the Cisco Developer Network at http://developer.cisco.com/web/sxml/home
Routing Rules Interface
Cisco Unified Communication Manager 8.0(1) supports the external call control (ECC) feature, which enables an adjunct route server to make call-routing decisions for Cisco Unified Communications Manager by using the 8.0(1) Cisco Unified Routing Rules Interface. When you configure external call control, Cisco Unified Communications Manager issues a route request that contains the calling party and called party information to the adjunct route server. The adjunct route server receives the request, applies appropriate business logic, and returns a route response that instructs Cisco Unified Communications Manager on how the call should get routed, along with any additional call treatment that should be applied.
For more information, see the Routing Rules Interface Tech Center on the Cisco Developer Network at http://developer.cisco.com/web/curri/home
Cisco maintains a policy of interface backward compatibility for at least one previous major release of Cisco Unified Communications Manager (Cisco Unified CM). Cisco still requires Cisco Technology Developer Program member applications to be retested and updated as necessary to maintain compatibility with each new major release of Cisco Unified CM.
The following practices are recommended to all developers, including those in the Cisco Technology Developer Program, to reduce the number and extent of any updates that may be necessary:
•The order of events and/or messages may change. Developers should not depend on the order of events or messages. For example, where a feature invocation involves two or more independent transactions, the events or messages may be interleaved. Events related to the second transaction may precede messages related to the first. Additionally, events or messages can be delayed due to situations beyond control of the interface (for example, network or transport failures). Applications should be able to recover from out of order events or messages, even when the order is required for protocol operation.
•The order of elements within the interface event or message may change, within the constraints of the protocol specification. Developers must avoid unnecessary dependence on the order of elements to interpret information.
•New interface events, methods, responses, headers, parameters, attributes, other elements, or new values of existing elements, may be introduced. Developers must disregard or provide generic treatments where necessary for any unknown elements or unknown values of known elements encountered.
•Previous interface events, methods, responses, headers, parameters, attributes, and other elements, will remain, and will maintain their previous meaning and behavior to the extent possible and consistent with the need to correct defects.
•Applications must not be dependent on interface behavior resulting from defects (behavior not consistent with published interface specifications) since the behavior can change when defect is fixed.
•Use of deprecated methods, handlers, events, responses, headers, parameters, attributes, or other elements must be removed from applications as soon as possible to avoid issues when those deprecated items are removed from Cisco Unified CM.
•Application Developers must be aware that not all new features and new supported devices (for example, phones) will be forward compatible. New features and devices may require application modifications to be compatible and/or to make use of the new features/devices.
What is New in Cisco Unified Communications Manager 8.5(1) API
This section gives information on the changes in the following APIs in the Unified CM release 8.5(1):
•Administrative XML API
•Serviceability XML API
•Extension Mobility API
•Web Dialer API
•Routing Rules API
Note Information on changes in Cisco JTAPI and Cisco TAPI and Wave Driver API are beyond the scope of this guide.
For information of Cisco TAPI and Wave Driver, see Cisco Unified TAPI Developers Guide for Cisco Unified Communications Manager and for information on Cisco JTAPI, see Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager for relevant release of Unified CM at the following location:
Administrative XML API
The following are the changes in the Administrative XML API in Unified CM release 8.5(1).
•Schema versioning updated.
•The following new APIs are added:
•The following APIs are updated:
For more information on the changes in the Administrative XML API, see the New and Changed Information in Unified CM Release 8.5(1) section in the Chapter 2 "Administrative XML Programming".
Serviceability XML API
The following are the changes in the Serviceability XML API in Unified CM release 8.5(1):
•The SelectCmDevice API returns SIP trunk status and also returns the IP addresses and status of the peer devices.
•The SelectCmDevice API returns a new reason code when the phone in Power Save Plus mode unregisters from Unified CM.
•SelectCmDevice API returns device information for a maximum of 1000 devices instead of the earlier 200 devices.
The following are the changes in Cisco Unified Serviceability in Unified CM release 8.5(1):
•New alarms are added to support the following features:
–Single Sign-On and Smart Card Authentication
–SIP Normalization and Transparency
•Existing alarms modified to support the Single Sign-On and the Smart Card authentication features.
•New perfmon counters added to support SIP Normalization and Transparency feature.
•New calledPartyPatternUsage CDR field added for hunt list support.
•New reason codes added for the EndPointTransientConnection and the EndPointUnregistered alarms.
•Textual conventions updated for the following MIB objects:
For more information on the changes in the Serviceability XML API, see the New Information for Unified CM 8.5(1) section in the Chapter 4 "Serviceability XML Programming".
Extension Mobility API
There are no changes in the Extension Mobility API in Unified CM release 8.5(1).
Web Dialer API
There are no changes in the Web Dialer API in Unified CM release 8.5(1).
Routing Rules API
There are no changes in the Routing Rules API in Unified CM release 8.5(1).