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
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:

  • 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

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:

  • 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





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
Simiral book on Amazon

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