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:

  • The Cisco CME TAPI Light implementation and capabilities
  • Cisco CME TSP functions
  • Cisco CRM Communications Connector

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
 ip source-address 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:

  • It allows multiple addresses on a single line.
  • It makes calls using address book dialing from applications.
  • It answers or rejects calls.
  • It holds calls using screen pop-ups.
  • It provides caller ID information to applications.
  • It places calls on hold and switches between active calls.
  • It transfers calls.

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

  • Media or voice termination is not supported. Media or voice traffic is sent to the phone. The TAPI application has access only to signaling events.
  • TAPI clients can operate on only one phone line at a time.
  • Multiple users and call handling of multiple calls on a single client are not supported.
  • Java TAPI (JTAPI) is not supported.

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




Answers the specified offered call.



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



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



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



Dials the specified dialable number on the specified call.



Drops or disconnects the specified call.



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



Retrieves the address identifier for the indicated call.



Returns detailed information about the specified call.



Returns the current status of the specified call.



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.



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



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



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



Places the specified call on hold.



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



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



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



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



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.



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.



Initiates a transfer of a call.



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:

  • Screen pop Opens a contact record and creates a new phone call activity record as a call arrives. Creates screen pops from click-to-dial calls as well as from manually dialed outbound calls.
  • Click-to-dial Allows the user to click a field on the PC screen and have the PC automatically dial a number. This feature is available from a Microsoft CRM contact record on your desktop.
  • Call duration tracking Tracks the duration of a phone call and associates it with the phone activity record.
  • Call information capture Captures incoming and outgoing call information, including calling number, called number, and call start and end times.
  • Customer record creation Creates a new CRM customer record when a new customer call arrives.

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

Part I: Cisco IP Communications Express Overview

Introducing Cisco IPC Express

Building a Cisco IPC Express Network

Cisco IPC Express Architecture Overview

Part II: Feature Operation and Applications

Cisco IP Phone Options

Cisco CME Call Processing Features

Cisco CME PSTN Connectivity Options

Connecting Multiple Cisco CMEs with VoIP

Integrating Cisco CME with Cisco CallManager

Cisco IPC Express Automated Attendant Options

Cisco IPC Express Integrated Voice Mail

Cisco CME External Voice Mail Options

Additional External Applications with Cisco CME

Part III: Administration and Management

Cisco IPC Express General Administration and Initial System Setup

Configuring and Managing Cisco IPC Express Systems

Cisco IPC Express System Configuration Example

Part IV: Maintenance and Troubleshooting

Troubleshooting Basic Cisco IPC Express Features

Troubleshooting Advanced Cisco CME Features

Troubleshooting Cisco CME Network Integration

Troubleshooting Cisco UE System Features

Troubleshooting Cisco UE Automated Attendant

Troubleshooting Cisco UE Integrated Voice Mail Features

Part V: Appendixes

Appendix A. Cisco IPC Express Features, Releases, and Ordering Information

Appendix B. Sample Cisco UE AA Scripts

Appendix C. Cisco Unity Express Database Schema


Cisco IP Communications Express(c) CallManager Express with Cisco Unity Express
Cisco IP Communications Express: CallManager Express with Cisco Unity Express
ISBN: 158705180X
EAN: 2147483647
Year: 2006
Pages: 236

Flylib.com © 2008-2020.
If you may any questions please contact us: flylib@qtcs.net