Table Of Contents
Preface
Introduction
Purpose
Audience
Organization
Related Documentation
Required Software
Supported Windows Platforms
Conventions
Obtaining Documentation
World Wide Web
Documentation CD-ROM
Ordering Documentation
Obtaining Technical Assistance
Cisco Connection Online
Technical Assistance Center
Documentation Feedback
Cisco Connection Online
Preface
This chapter introduces Cisco Telephony Application Programmer's Interface (TAPI) implementation, describes the purpose of this document, and outlines the required software. The following topics are included:
•
Introduction
•
Purpose
•
Audience
•
Organization
•
Related Documentation
•
Required Software
•
Conventions
•
Obtaining Documentation
•
Obtaining Technical Assistance
•
Obtaining Documentation
Introduction
Telephony Application Programmer's Interface (TAPI) is the set of classes and principles of operation that constitute a telephony application programming interface. TAPI implementations are the interface between computer telephony applications and telephony services. The Cisco CallManager includes a TAPI Service Provider (Cisco TSP). This TAPI service provider allows developers to create customized IP telephony applications for Cisco users, for example, voice mail with other TAPI compliant systems, automatic call distribution (ACD), and caller ID screen pops. The TSP enables the Cisco IP Telephony system to understand commands from the user-level application such as Cisco SoftPhone via the operating system.
The Cisco TAPI implementation uses the Microsoft TAPI v2.1 specification and supplies extension functions to support the Cisco IP Telephony Solutions. To enable a Cisco TAPI-based solution, three things are essential:
•
TAPI support/service running on the operating system
•
A TAPI-based software application
•
A Cisco IP Telephony phone system
Purpose
This document describes the Cisco TAPI implementation, detailing the functions that comprise the implementation software and illustrating how to use these functions to create applications that support the Cisco IP Telephony hardware, software and processes. This manual is meant to be used with the Cisco CallManager manuals to develop applications.
One of the primary goals of a standard Application Programming Interface (API) such as TAPI is to provide an unchanging programming interface under which varied implementations may stand. Cisco's goal in implementing TAPI for the Cisco CallManager platform is to conform as closely as possible to the TAPI specification, while providing extensions that enhance TAPI and expose the advanced features of Cisco CallManager to applications.
As new versions of Cisco CallManager and the Cisco TSP are released, variances in the API should be very minor, and should tend in the direction of compliance. Cisco is committed to maintaining its API extensions with the same stability and reliability, though additional extensions may be provided as new Cisco CallManager features become available
Audience
This document is intended for telephony software engineers who are developing Cisco telephony applications that require TAPI. This document assumes that the engineer is familiar with both the C or C++ languages and the Microsoft TAPI specification.
Organization
Related Documentation
For more information on the TAPI specification, on creating an application to use TAPI, or on TAPI administration see:
•
Microsoft TAPI 2.1 Features:
http://www.microsoft.com/NTServer/commserv/exec/feature/tapi21.asp
•
Getting Started with Windows Telephony
http://www.microsoft.com/NTServer/commserv/deployment/planguides
/getstartedtele.asp
•
Windows Telephony API (TAPI)
http://www.microsoft.com/NTServer/commserv/exec/overview
/tapiabout.asp
•
Creating Next Generation Telephony Applications:
http://www.microsoft.com/NTServer/commserv/techdetails/prodarch
/tapi21wp.asp
•
The Microsoft Telephony Application Programming Interface (TAPI) Programmer's Reference
•
"For the Telephony API, Press 1; For Unimodem, Press 2; or Stay on the Line" —A paper on TAPI by Hiroo Umeno a COMM and TAPI specialist at Microsoft.
•
"TAPI 2.1 Microsoft TAPI Client Management"
•
"TAPI 2.1 Administration Tool"
Required Software
•
Cisco CallManager version 3.0(5) on the Cisco CallManager server
•
Microsoft Internet Explorer 4.01 or later
Supported Windows Platforms
Cisco TAPI is supported on all Windows operating systems. Depending on the type and version of your operating system, you may need to install a service pack.
•
Windows 2000
–
TAPI 2.1 is included with Windows 2000.
•
Windows NT Server 4.0 or Windows NT Workstation 4.0
–
Service Pack 5 (SP5) includes TAPI 2.1
–
SP5 is available via download from Microsoft.
•
Windows 98
–
TAPI 2.1 is included with Windows 98.
•
Windows 95
–
TAPI 2.1 is provided by Microsoft.
Note
Check %SystemRoot%\system32 for these dynamically loaded library (.dll) files
and versions:
msvcrt.dll version: 6.00.8397.0
msvcp60.dll version: 6.00.8168.0
mfc42.dll version: 6.00.8447.0
Conventions
This document uses the following conventions:
Convention
|
Description
|
boldface font
|
Commands and keywords are in boldface.
|
italic font
|
Arguments for which you supply values are in italics.
|
[ ]
|
Elements in square brackets are optional.
|
{ x | y | z }
|
Alternative keywords are grouped in braces and separated by vertical bars.
|
[ x | y | z ]
|
Optional alternative keywords are grouped in brackets and separated by vertical bars.
|
string
|
An unquoted set of characters. Do not use quotation marks around the string or the string will include the quotation marks.
|
screen font
|
Terminal sessions and information the system displays are in screen font.
|
boldface screen font
|
Information you must enter is in boldface screen font.
|
italic screen font
|
Arguments for which you supply values are in italic screen font.
|
|
This pointer highlights an important line of text in an example.
|
^
|
The symbol ^ represents the key labeled Control—for example, the key combination ^D in a screen display means hold down the Control key while you press the D key.
|
< >
|
Nonprinting characters, such as passwords are in angle brackets.
|
Notes use the following convention:
Note
Means reader take note. Notes contain helpful suggestions or references to material not covered in the publication.
Obtaining Documentation
World Wide Web
You can access the most current Cisco documentation on the World Wide Web at http://www.cisco.com, http://www-china.cisco.com, or http://www-europe.cisco.com.
Documentation CD-ROM
Cisco documentation and additional literature are available in a CD-ROM package, which ships with your product. The Documentation CD-ROM is updated monthly. Therefore, it is probably more current than printed documentation. The CD-ROM package is available as a single unit or as an annual subscription.
Ordering Documentation
Registered CCO users can order the Documentation CD-ROM and other Cisco Product documentation through our online Subscription Services at http://www.cisco.com/pcgi-bin/subcat/kaojump.cgi.
Nonregistered CCO users can order documentation through a local account representative by calling Cisco's corporate headquarters (California, USA) at 408 526-4000 or, in North America, call 800 553-NETS (6387).
Obtaining Technical Assistance
Cisco provides Cisco Connection Online (CCO) as a starting point for all technical assistance. Warranty or maintenance contract customers can use the Technical Assistance Center. All customers can submit technical feedback on Cisco documentation using the web, e-mail, a self-addressed stamped response card included in many printed docs, or by sending mail to Cisco.
Cisco Connection Online
Cisco continues to revolutionize how business is done on the Internet. Cisco Connection Online is the foundation of a suite of interactive, networked services that provides immediate, open access to Cisco information and resources at anytime, from anywhere in the world. This highly integrated Internet application is a powerful, easy-to-use tool for doing business with Cisco.
CCO's broad range of features and services helps customers and partners to streamline business processes and improve productivity. Through CCO, you will find information about Cisco and our networking solutions, services, and programs. In addition, you can resolve technical issues with online support services, download and test software packages, and order Cisco learning materials and merchandise. Valuable online skill assessment, training, and certification programs are also available.
Customers and partners can self-register on CCO to obtain additional personalized information and services. Registered users may order products, check on the status of an order and view benefits specific to their relationships with Cisco.
You can access CCO in the following ways:
•
WWW: www.cisco.com
•
Telnet: cco.cisco.com
•
Modem using standard connection rates and the following terminal settings: VT100 emulation; 8 data bits; no parity; and 1 stop bit.
–
From North America, call 408 526-8070
–
From Europe, call 33 1 64 46 40 82
You can e-mail questions about using CCO to cco-team@cisco.com.
Technical Assistance Center
The Cisco Technical Assistance Center (TAC) is available to warranty or maintenance contract customers who need technical assistance with a Cisco product that is under warranty or covered by a maintenance contract.
To display the TAC web site that includes links to technical support information and software upgrades and for requesting TAC support, use www.cisco.com/techsupport.
To contact by e-mail, use one of the following:
Language
|
E-mail Address
|
English
|
tac@cisco.com
|
Hanzi (Chinese)
|
chinese-tac@cisco.com
|
Kanji (Japanese)
|
japan-tac@cisco.com
|
Hangul (Korean)
|
korea-tac@cisco.com
|
Spanish
|
tac@cisco.com
|
Thai
|
thai-tac@cisco.com
|
In North America, TAC can be reached at 800 553-2447 or 408 526-7209. For other telephone numbers and TAC e-mail addresses worldwide, consult the following web site: http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml.
Documentation Feedback
If you are reading Cisco product documentation on the World Wide Web, you can submit technical comments electronically. Click Feedback in the toolbar and select Documentation. After you complete the form, click Submit to send it to Cisco.
You can e-mail your comments to bug-doc@cisco.com.
To submit your comments by mail, for your convenience many documents contain a response card behind the front cover. Otherwise, you can mail your comments to the following address:
Cisco Systems, Inc.
Document Resource Connection
170 West Tasman Drive
San Jose, CA 95134-9883
We appreciate and value your comments.
Cisco Connection Online
Cisco Connection Online (CCO) is Cisco Systems' primary, real-time support channel. Maintenance customers and partners can self-register on CCO to obtain additional information and services.
Available 24 hours a day, 7 days a week, CCO provides a wealth of standard and value-added services to Cisco's customers and business partners. CCO services include product information, product documentation, software updates, release notes, technical tips, the Bug Navigator II, configuration notes, brochures, descriptions of service offerings, and download access to public and authorized files.
CCO serves a wide variety of users through two interfaces that are updated and enhanced simultaneously: a character-based version and a multimedia version that resides on the World Wide Web (WWW). The character-based CCO supports Zmodem, Kermit, Xmodem, FTP, and Internet e-mail, and it is excellent for quick access to information over lower bandwidths. The WWW version of CCO provides richly formatted documents with photographs, figures, graphics, and video, as well as hyperlinks to related information.
You can access CCO in the following ways:
•
WWW: http://www.cisco.com
•
WWW: http://www-europe.cisco.com
•
WWW: http://www-china.cisco.com
•
Telnet: cco.cisco.com
•
Modem: From North America, 408 526-8070; from Europe, 33 1 64 46 40 82. Use the following terminal settings: VT100 emulation; databits: 8; parity: none; stop bits: 1; and connection rates up to 28.8 kbps.
For a copy of the CCO Frequently Asked Questions (FAQ), contact cco-help@cisco.com. For additional information, contact cco-team@cisco.com.
Note
If you are a network administrator and need personal technical assistance with a Cisco product that is under warranty or covered by a maintenance contract, contact the Cisco Technical Assistance Center (TAC) at 800 553-2447, 408 526-7209, or tac@cisco.com. To obtain general information about Cisco Systems, Cisco products, or upgrades, contact 800 553-6387, 408 526-7208, or cs-rep@cisco.com.