TAPI Service Provider

From Pbxnsip Wiki

Contents 1 Introduction 2 System Requirement 3 Installation 4 Configuration 5 Using the pbxnsip TAPI Service Provider’s Functionality 6 Removing the TAPI Service Provider

Introduction

The Telephony Application Programming Interface (TAPI) was introduced in 1993 in a joint development by Microsoft Corp. and Intel Corp., that sparked the new telecommunication capability to provide interfaces which allowed the uses of telephone and media services across Microsoft Windows platforms and other well known operating systems, and enabled high-end applications to use IP Telephony (VoIP). These are the interfaces that are still becoming more affordable and widely accepted by homeowners, small-to-medium businesses and major corporations whom frequently use the Internet.

System Requirement

• pbxnsip version 2.0.4 or later is required.
• The pbxnsip TAPI add-on software is currently available for Windows 2000, NT, Vista, and XP.
• If the firewall is running, it is necessary to create or add an exception for the firewall software for the SIP TCP, UDP and TLS ports; otherwise, the firewall will block the SIP traffic. Please refer to your firewall documentation to perform this task.

Installation

If you haven’t downloaded the pbxnsip TAPI add-on software yet, please visit http://www.pbxnsip.com/software.

1. Run the InstallSheild wizard pbxtsp11.exe
2. Click on the "Next" button
3. Click on the "Install" button
4. If the installation is successful, you will see the "Wizard Completed", click on the "Finish" button.

Configuration

Prior to making any calls, The TAPI add-on software needs to be configured correctly.

In order to open up the pbxnsip TAPI configuration dialog, do the following (for Windows XP):

1. Navigate to Start->Control Panel
2. Click on "Phone and Modem Options"
3. On the "Phone and Modem Options" dialog, click on the Advanced tab
4. Select pbxnsip TAPI service provider
5. Then click on the "Configure" button
6. Fill out the username, password, domain and the IP Address of the PBX (*see below),
7. Then click on the "Ok" button, and close the “Phone and Modem Options” dialog.

In the configuration dialog, the following settings are available:

• Username: Extension number in the PBX
• Password: Password of the provided extension.
• Domain: The Domain of the extension. By default, "localhost" is the domain, however if the name has been changed, change the domain setting to the current PBX domain.
• Address of the PBX: IP address of the PBX (e.g. "192.168.1.2"). Likewise, You can use a DNS name of the PBX (e.g. company.com), however, The TAPI software does not perform a DNS NAPTR or SRV resolution, only DNS A is performed. If the current PBX SIP TCP/UDP port it is not the standard port (port 5060), please make sure that the port is included. This can be achieved by include a colon before the port (e.g. "192.168.1.2:5080").

Using the pbxnsip TAPI Service Provider’s Functionality

To make a call with Microsoft Outlook, using the Contacts folder

1. Open up the Microsoft Outlook software
2. Click on the Contacts folder in Outlook shortcut pane
3. In the Contacts folder, select the desired contact you want to call
4. Click the telephone button and then click on “Start call” button

• This also can be achieved by right-clicking the contact and select “Call Contact” and click on “Start call” button …
• Alternatively, on the menu, you can navigate to Action->Call Contact and select the contact’s phone numbers you want to call.

1. To end the current call, simply click on the “End Call” button.

To make a call with Microsoft Outlook, using the address book

1. On the menu, navigate to Tool->Address Book, or simultaneously press Control-Shift-B
2. In the address book dialog, highlight the desired contact,
3. Click on the “Action” button and select Dial…

• This can also be achieve by right-clicking the contact and hover your mouse pointer to Action->Dial…

1. A “New Call” dialog box will show as similarly show in previous example with different layout, simply click on the “Call” button to initiate the call.
2. To end the current call, click on the “Disconnect” button

Note: The contact from the Contacts folder or from the address book must have the phone number in his or her contact information.

Note: The previous method as described uses the Microsoft Phone Dialer by default, which you can use it’s interface with the pbxnsip TAPI add-on software. There are also other IP telephony-based programs that may work with the pbxnsip add-on software.

To make a call with Microsoft Phone Dialer

1. Navigate to Start->Run
2. Type in dialer and click on the “Ok” button
3. When the program opens up, click on the “Dial” button and fill out the desired phone number, or as aforementioned before, select your contacts.
4. Click on the “Place Call” button
5. To end the current call click on the “Disconnect” button

Removing the TAPI Service Provider

There are two ways to do that, the first method is recommended:

Using the "Phone and Modem Options" dialog

1. Navigate to Start->Control Panel->Phone and Modem Options (for Windows XP)
2. In the "Phone and Modem Options" dialog, click on the Advanced tab
3. Select pbxnsip TAPI service provider, and then click on the "Remove" button

Using the "Add or Remove Programs"

1. Navigate to Start->Control Panel-> Add or Remove Programs
2. Scroll down and select "PBX TSP" and click on the "Remove" button
3. You will get a prompt "Are you sure you want to remove PBX TSP from you computer?" Click on the "Yes" button.
4. No other user-interaction is need at that point. The removal process will take a couple minutes.

• Alternatively, you can also run the InstallSheild wizard pbxtsp10.exe, which allows you to remove the TSP in the same manner as you would when removing from the "Add or Remove Program".
• The wizard also allows you to modify and repair the add-on software.