TAPI Applications

TAPI is a Microsoft software application interface for integrating-telephony-services into Windows-based PC applications. Cisco CME provides telephony services via a TAPI Service Provider (TSP) interface to applications.

The TSP allows TAPI-based applications such as Microsoft Outlook and Microsoft Customer Relationship Management (CRM) to provide call control to the IP phones connected to Cisco CME. Other TAPI-based applications are available in the industry, such as automatic dialers. You can use these applications to control an IP phone to make and receive calls via a computer or to trigger database lookups based on caller ID.

The following sections describe TAPI in more detail, including the following topics:

Cisco CME TAPI Light

Cisco CME offers a TAPI Light capability, which is not a full TAPI implementation but a selection of the applicable components for Cisco CME. The implementation consists of two parts: one part resides on the Windows platform, and the other part resides in Cisco CME's Cisco IOS software.

The interface between the TSP in the Windows application and Cisco CME uses SCCP over TCP. Cisco CME listens on a standard TCP port, while the TAPI client authenticates to Cisco CME by providing a username and password unique for each IP phone on Cisco CME. The Windows application's TSP must have the same username, password, and port number configured to be able to connect successfully with Cisco CME and exert phone and call control. The username and password authentication provides a layer of security to Cisco CME to enable authorized application development.

Example 12-1 shows the configuration of the username and password associated with the IP phone on Cisco CME. This information must be quoted by the TAPI application during login to be able to control the phone. The telephony-service ip source-address command specifies the port number used for communication between Cisco CME and the TAPI application.

Example 12-1. IP Phone Configuration

router#show running-config telephony-service ip source-address 172.19.153.129 port 2000 ! ephone-dn 1 number 3001 description User1 name User1 call-forward busy 3105 call-forward noan 3105 timeout 10 ! ephone 1 username "User 1" password user1 mac-address 0009.B7F7.5793 speed-dial 4 3100 label "AA" button 1:1

You can verify IP phone TAPI application login status with the show ephone login Cisco CME command.

Cisco CME TSP Functions

The Cisco CME TSP provides the following functions:

When using TAPI applications with Cisco CME, consider the following restrictions:

Cisco has partnered with independent TAPI developers to provide support for TAPI development.

Table 12-1 lists the TAPI and TSP functions supported in the Cisco CME TSP.

Table 12-1. Supported Cisco CME TAPI/TSP Functions

TAPI Function

TSP Function

Description

lineAnswer

TSPI_lineAnswer

Answers the specified offered call.

lineBlindTransfer

TSPI_lineBlindTransfer

Performs a blind or single-step transfer of the specified call to the specified destination address.

lineClose

TSPI_lineCloseCall

Closes the specified open line device after completing or aborting all outstanding calls and asynchronous operations on the device.

lineCompleteTransfer

TSPI_lineCompleteTransfer

Completes the transfer of the specified call to the party connected in the consultation call.

lineDial

TSPI_lineDial

Dials the specified dialable number on the specified call.

lineDrop

TSPI_lineDrop

Drops or disconnects the specified call.

lineGetAddressID

TSPI_lineGetAddressID

Returns the address identifier associated with the address in a different format on the specified line.

 

TSPI_lineGetCallAddressID

Retrieves the address identifier for the indicated call.

lineGetCallInfo

TSPI_lineGetCallInfo

Returns detailed information about the specified call.

lineGetCallStatus

TSPI_lineGetCallStatus

Returns the current status of the specified call.

lineGetDevConfig

TSPI_lineGetDevConfig

Returns a data structure object, the contents of which are specific to the line (service provider [SP]) and device class, giving the current configuration of a device associated one-to-one with the line device.

 

TSPI_lineGetExtensionID

Returns the extension identifier that the SP supports for the indicated line device.

lineGetID

TSPI_lineGetID

Returns a device identifier for the specified device class associated with the selected line, address, or call.

 

TSPI_lineGetNumAddressIDs

Retrieves the number of address identifiers supported on the indicated line.

lineHold

TSPI_lineHold

Places the specified call on hold.

lineMakeCall

TSPI_lineMakeCall

Places a call on the specified line to the specified destination address.

lineNegotiateExtVersion

TSPI_lineNegotiateExtVersion

Returns the highest extension version number the service provider can operate under for this device, given the range of possible extension versions.

 

TSPI_lineNegotiateTSPIVersion

Returns the highest service provider interface (SPI) version the service provider can operate under for this device, given the range of possible SPI versions.

lineOpen

TSPI_lineOpen

Opens the line device whose device identifier is given, returning the service provider's handle for the device.

lineSetCallParams

TSPI_lineSetCallParams

Sets certain parameters for an existing call.

 

TSPI_lineSetDefaultMedia Detection

Tells the service provider the new set of media types to detect for the indicated line, replacing any previous set.

lineSetStatusMessages

TSPI_lineSetStatusMessages

Lets TAPI specify which notification messages the service provider should generate for events related to status changes for the specified line or any of its addresses.

lineSetupTransfer

TSPI_lineSetupTransfer

Initiates a transfer of a call.

lineUnhold

TSPI_lineUnhold

Retrieves the specified held call.

 

Cisco CRM Communications Connector

The Cisco CRM Communications Connector (CCC) integrates Cisco CME with the Microsoft Business Solution Customer Relationship Management (Microsoft CRM) application. Cisco CCC provides an easy-to-use IP phone application using Microsoft Outlook or Internet Explorer as the PC client software for managing tasks and contacts.

Cisco CCC offers the following application capabilities:

Two pieces of software must be installed to activate the CRM application: one on the Microsoft CRM Server (Cisco CCC server software), and the other on each CRM client PC (Cisco CCC client software). In addition, the Cisco CME TSP driver is installed on each client. The Microsoft CRM Client can use Microsoft Outlook or an HTML interface as the client software.

For further information on Cisco and Microsoft solutions, go to http://www.cisco.com/go/ciscomicrosoftsmb.

For information on the CRM Express Solution Specialization, visit http://www.cisco.com/go/specialization.

For more information on the installation of Cisco CCC, go to Cisco.com, and search for "Cisco CRM Communications Connector for Cisco CallManager Express."

Extensive Markup Language Applications

Категории