TAPI Driver Installation
How to use the PASCOM TAPI Driver for Windows in order integrate TAPI enabled software such as MS Office, ERP and CRM systems etc.
The PASCOM TAPI can be installed on any windows desktop. The TAPI Driver will then register itself with the PASCOM cloud phone system using the same credentials as the PASCOM App, which means the TAPI is assigned to a user rather than being directly connected to a telephone.
When a dial command is sent to PASCOM via TAPI, PASCOM will automatically select the current phone of the user and use this phone to make the call. If the user then changes their location or phone, the TAPI will not require any reconfiguration.
The PASCOM TAPI functions independently of the PASCOM Desktop App.
Supported TAPI Functions
The TAPI Interface specifies a number of call related functions, of which the following are supported by the PASCOM TAPI:
Signalization of incoming calls
Signaling of phone numbers, call directions, further details
Pickup
Complete a pick up on a certain extension
Hold
Place an active call on hold
Resume
Retrieve the held calls
Hang Up
End calls
Call Origination
Initiate calls to a number
Call Termination
Automatically terminate calls on the phone
Configure the Trunk Code for TAPI
When configuring or first using the TAPI interface, you will be asked for the to be used dial settings. However, phone number handling i.e. setting a 0 for outbound calls, international formatting etc etc. is done exclusively by the PASCOM cloud phone system server, meaning the settings added in windows will be ignored.
The arear code is a mandatory field. Enter your area code without the leading 0. All other fields should be left empty.
This dialog is accessible under Control Panel > Phone and Modem > Dialling Rules (My location) > Edit.

TAPI Driver Installation
Configure ports for TAPI
Use our port-overview to make the necessary approvals for the PASCOM TAPI.
TAPI Software Download
The current PASCOM TAPI Driver Versopn can be downloaded from the PASCOM Homepage.
Installation on a Windows Computer
Start the setup procedure using the file you just downloaded, accept the terms and conditions and finally all the necessary components will be installed.
After the installation has been successfully completed, you will need to configure the connection of the TAPI to PASCOM:

As stated before, the TAPI will login with the same user data just like the PASCOM App
Username
username@instance
Password
users´ password
mobydick Server
IP number of hostname of the PASCOM Server
You can now confirm the successful installation by clicking on Finish.
Installation on a Terminal Server
Configuration of the PASCOM Phone System
Should you wish to install the TAPI on a Terminal Server or on a computer that is used by more than one person, then you will need assign the users, who will connect using the TAPI, with the xmpp.supervisor Role. This means that only one individual XMPP connection will be constructed from the Terminal Server, over which the total communication will be transmitted.

Installation
Start the setup procedure using the file you just downloaded, accept the terms and conditions and finally all the necessary components will be installed.
After the installation has been successfully completed, you will need to configure the connection of the TAPI to PASCOM:

As stated before, the TAPI will login with the same user data just like the PASCOM App.
Username
username@instance
Password
users´ password
mobydick Server
IP number or hostname of the PASCOM Server
Now a further dialogue box will appear, in which you will be able to select the users, who should be available later within TAPI applications (e.g. MS Outlook). All the existing users will be displayed within the list. In order to choose a user, one can double click on the desired user or use the buttons in between the two list screens:

You can now confirm the successful installation by clicking on Finish.
Example scenario with Microsoft Outlook
Start Outlook and select the desired contact entry.
Using the right mouse button, select the number to call from the drop down menu:

Now the New Call window will appear: confirm the number by clicking Start call:

Now your telephone should make the call.
By clicking Dial Options you can select line to be used:

Unattended (Silent) Installation
It is also possible to install the TAPI without needing any GUI interaction. In order to do this, the installations programme must be called up using the following options:
If the TAPI user has the xmpp.supervisor Role, all available users will be automatically selected and will then be available within the TAPI application.
TAPI Debugging
If you uncover a problem when using the TAPI Driver, you can use this manual to start a TRACE, which can then be analyzed by PASCOM and helping in finding a solution.
Preparation
In order to record the TAPI debug output, you will need the DebugView tool from Microsoft/Sysinternals which can be downloaded here: https://technet.microsoft.com/en-us/library/bb896647.aspx In addition, it is often also a good idea to record the call construction by using the tool "Tapi Master Line Watcher"(https://www.tapimaster.eu/de/de_tools_linewatcher.html) in parallel to the Debug tool
Install the PASCOM TAPI Driver in the Debug-Version
In order to be able to record Debug Output, the debug version of the PASCOM driver must be installed. Whether you have the productive or debug version installed can be easily identified using the configurations dialog.
Go to the command panel > telephone and modem
Go to the "Advanced" Tab
Select the entry "pascom TAPI Service Provider"

Click Configure
If in the following mask, the warning "WARNING: DEBUG VERSION INSTALLED" appears, then clearly the Debug-Version is installed

Should you still not be certain, then please close all programmes and run the setup again. Please take note of the installation notices and during the installation select, "Debug" and confirm this by clicking next.

This will replace any productive versions installed with the Debug version
Preforming a Debugging
You now have all the necessary components downloaded and installed, so start the required tools
Open DebugView
Start the DebugView.exe with Administrator Privileges by right clicking and selecting
Run as Administrator.

Under the "Capture" menu, please check the "Capture Global Win32" option. If you did not run the programme as an administrator, a error message will appear.

Open Line Watcher
Start the programme - no special permissions required
In the Drop Down under the first tab, select the user´s TAPI Line causing the problems
Check the options box "More information"

Next, start your TAPI software and follow those steps which lead to the problem. In the DebugView window, a whole range of tasks should be visible. As long as you start or receive a call information should also appear in Line Watcher.

Once the test is finished, save both trace outputs from both applications (DebugView and LineWatcher).

Saving a DebugView Trace
Click on File > Save as
Give it an appropriate name
Save
Saving a LineWatcher Trace
Click on "Save Message Flow"
Give it an appropriate name
Save
You can now send both files to PASCOM for analysis.
Last updated
Was this helpful?
