1. Introduction

1.1. About program...

Blitz KXTD TAPI Server - there is CTI application 3-d party for PBX Panasonic KX-TD/KX-TDA, which allows to distribute incoming calls on Caller ID number, to conduct statistic of incoming, outgoing calls and to pass information about calls to software of others manufacturers. Also this software is intended for organizations of Call center and CRM systems on base of already working system of account of the enterprise and PBX Panasonic KX-TD, KX-TDA.

It is possible to receive Caller ID number of PBX Panasonic KX-TD, KX-TDA at incoming calls:

The format of number of calling subscriber can be differ for various types of CO-lines and for various operators of communication, which are connected to PBX but Blitz KXTD TAPI Server allows to reduce them to the uniform format.

For work Blitz KX-TD TAPI Server need preset Base Data Server and corresponding ODBC driver. It may be:

Blitz KXTD TAPI Server consists of two main applications:
Blitz_KXTDServTAPI - intended for distribution incoming outside calls on certain EXT numbers in conformity to the filled tables of DB, and also for drop of incoming calls with certain numbers Caller ID. Blitz KXTD TAPI Server uses the type of DB which was selected by the subscriber from the list. Supported types of DB: FireBird, MS-SQL, MY-SQL and Oracle.
Blitz KXTDServConsole - with this software all necessary settings for work of service are input. This software allows to operate it, fill the tables, necessary for work and to look through archive of calls. At start it checks availability of necessary DB tables and in case if one of this table is absent creates new one. It is possible to fill the tables both in Blitz KXTD Serv Console and from any other software with SQL query.

1.2. System requirements

Checked up platforms: Windows 2000/XP/2003. It can work with any EXT lines (except for ISDN, BRI, DECT) and with any telephone device.

Hardware:
For functioning Blitz KXTD TAPI Server the computer must satisfy to the following requirements:
The processor from Pentium-1 or higher or compatible with it;
128 Mbytes of RAM;
2 Mbytes of memory on the hard disk;
Free COM port to connect PBX;
Operative system Microsoft Windows NT 4.0(SP5)/2000/2003/XP.
The version firmware of the PBX must be:
KX-TD 816 - not less 5 ver. (it is desirable 6 ver.)
KX-TD 1232 - not less 5 ver. (it is desirable 6. ver.)
KX-TD 500 - not less 2.3 (it is desirable 2.6)
KX-TDA anyone (it is desirable 2.0)

1.3. Specifications influencing the decision of this task

  1. For PBX Panasonic KX-TD/KX-TDA this task is solved only by functions of control PBX through TAPI, and active control can be done only by TAPI EXT lines, on TAPI CO lines you can only observe.
  2. It is possible to redirect incoming calls on TAPI line EXT only with 2 TAPI functions - Transfer and Redirect. Thus, before realization of any of this function, the PT on which call comes can ring only one time.
  3. It is possible to drop incoming outside call only from hybrid or digital EXT line with connected APT or DPT system device.

1.4. Applications

1.4.1. Blitz_KXTDServTAPI

Blitz_KXTDServTAPI - works as Windows-service and fulfils all main tasks.
  1. If number Caller ID was defined at incoming outside call this number will be modified on the special table of modification.
  2. If number DID was defined, this number is verified on field DID of table DID_DIL 1:1_Extended and also EXT number on which the call came is verified with number pointed out in the field EXT_Victim. If there is no conformity in this table, then number of CO line on which the call came is verified with field CO of DID_DIL11_Extended table, and also EXT number on which the call came is verified with number, pointed out in the field EXT-Victim of this table. If there is no such conformity too, then processing of this call on function transfer and drop call will be finished.
  3. Then the modification of Caller ID number is verified on field Caller ID of table Caller ID. If there is the log in table with this Caller ID and field EXT 1 is filled, then the Transfer of call is made to the EXT line, which is pointed out in this field or its drop (code "1"). If field EXT 1 didn't fill, or "0" pointed in this field, or intercom call on which there was an attempt to transfer the call is busy, then fields EXT 2 and EXT 3 are processed in the same way.
  4. If all three fields EXT 1, EXT 2, EXT 3 are empty, or all EXT numbers pointed in this fields are busy, or number of Caller ID call was not found in the table Caller ID, or number Caller ID was defined, then the attempt to transfer incoming call to number which is pointed out in the field EXT_Default of table DID_DIL11_Extended is fulfilled. If this field is empty, then the call will not be transferred anywhere.
  5. To transfer or drop call the table of distribution calls, Caller ID has greater priority, in comparison with the table DID_DID11_Extanded. But if there are no conformity of numbers DID, CO and number EXT_Victim in the table DID_DIL11_Extended to DID numbers or CO and intercom EXT numbers on which the call came, then this call will not be transferred anywhere.
  6. When incoming call was completed the log in the table of contacts (LogIncCalls) is formed, the number of incoming call, time and date when the call came, the time of answering the call, duration, EXT number on which the call came are pointed in this table. If the call has not answered, time of answer for a call and duration of conversation remains "zero".
  7. When outgoing call was completed the log in the table of outgoing calls (LogOutCalls) is formed. The dialed number, figures dialed after number, time and date of the beginning of the calls from the moment when the handset was raised, time of answering the call, EXT number from which the call was made are pointed in this table.
  8. User can use the data from these two tables in other software.
  9. There are three ways to pass events about incoming call:
    1. For each incoming and manually transferred call the empty file is created. Caller ID and EXT number, on which the call came, contain the name of this file.
    2. At work with DB MS-SQL for each incoming manually transferred call the saved procedure with this name is caused and at answered the call the procedure with other name is caused.
    3. At incoming and manual transferred call with TCP/IP protocol, manager receives information about call as text line which contains Caller ID Number, DID/DDI number, CO number and EXT number.

1.4.2. Blitz_KXTDServConsole

Blitz_KXTDServConsole - there is a console of control.
  1. Blitz_KXTDServConsole - sets parameters of connection to DB, which is used by main application Blitz_KXTDServTAPI. At successful connection to DB, Blitz_KXTDServConsole checks presence of all necessary tables. In case one of these tables is absent this application creates new one.
  2. It sets parameters of start Blitz_KXTDServTAPI - there are 3 types of start (manual, automatic, disabled). It allows to start, stop, restart, select user's name and password from which Blitz_KXTDServTAPI will be started.
  3. It gates out the contents of all DB tables, allows to edit the contents of tables DID_DIL11_Extended, CallerID and ClientsID.
  4. It allows to create and edit the contents of table of CallerID modification. This table has dbf format and the layout of the file of this table is set up by user.

1.5 Installation of the Program for the KX-TD station.

1.5.1. General items of KX-TD information.

Stations KX-TD 812/1232 with one main block have only 1 universal RS-232 port which is used and for transfer SMDR, and for programming, and for TAPI-interface. And at certain moment only one function from this list written above can work.

System of station KX-TD 1232 from 2 main blocks has 2 RS-232 ports. But TAPI-interface works only RS-232 station "Master". For SMDR or Program exchange you can use R-232 on station "Slave".

Stations KX-TD 500 have 1 port RS-232 for transfer the information. TAPI-interface works on anyone from RS-232 ports stations KX-TD 500. We recommend in case KX-TD 500 to use RS-232 port SMDR for initialization of TAPI-interface. To solve problem of ports lack RS-232 for station KXTD at initialization of TAPI-interface or to combine reception on one port RS-232 and SMDR messages and TAPI-interface, we offer the program of reception SMDR information on TAPI-interface.

Connection PBX to the computer.

For KX-TD to connect computer to PBX the RS-232C cable is required. On the computer side the cable is connected to free socket of one of COM-ports (most computer are equipped with 2 Com-ports, designated as “ COM 1” and “COM 2”). Contact sockets type “father” either 25 or 9 are used on computer. Standard Cable of serial port for TAPI interface operation PBX KX-TD can not be used. Below there is a circuit, according to which, you can make a cable suitable for using PBX KX-TD.

Station KX-TD connects with computer of the user and TAPI-server is carried out using RS-232C, with soldering described in the firm documentation on installation PBX Panasonic KX-TD. This cable is also used to receive the information SMDR and programming station KX-TD.

Standard cable for COM port for operation TAPI interface PBX KX-TD doesn't approach. You can make a suitable cable for work with series PBX KX-TD on the scheme given below.

Soldering the cable RS-232 C
Part 1 (9pins connector)
Port RS-232 C series KX-TD (25 pins) Port RS-232 C on PC (9 pins)

Part 2 (25 pins connector)
Port RS-232 C series KX-TD (25 pins) Port RS-232 C on PC (25 pins)

Besides, it is recommended to connect metallic frames of socket by separate wire.

For detailed information about address to the firm documentation on installation PBX Panasonic KX-TD.

1.5.2. Installation on computer which directly connected to PBX with RS-232 port.

For installation the program on the individual computer you need to download TSP driver for KX-TD system, and also instructions on its installation.
  1. Download TSP driver for KX-TD systems, as well as instruction for their installation (tspinst177.zip, PanasonicTSP-eula.pdf, KXTDtspinstman.pdf, tspinstmanFrom167.pdf).
  2. Connect PBX systems Panasonic KX-TD to the computer with cable the soldering pointed above. Install TSP driver KX-TD version 1.77 on the computer on OS Windows not later than NT. 4.0 according to the instructions pointed above, and check its efficiency.
  3. Download the Blitz KXTD TAPI Server installations Setup_Blitz_KXTD_TAPI_Server.zip.
  4. Run the program of installation Setup_Blitz_KXTD_Server_TAPI.exe and following instructions.
  5. Run Blitz_KXTDServConsole.exe. Set parameters for connection to Date Base Server and another setting of Blitz KX-TD TAPI Server.

1.6. Installation for Panasonic KX-TDA systems

For KX-TDA connection is carried out using USB cable or through connection to CTI-link card.

1.6.1 Installation steps for Panasonic KX-TDA systems using USB cable:

  1. Download USB and TSP driver for KX-TDA systems, as well as instruction for their installation (PanasonicTSP-eula.pdf, USB_old_driver_remove.doc, USB_TDA_WinXX.zip, KXTDATSPInstManual.pdf, panasonic_kx-tda_tsp_inst2117.zip).
  2. Connect PBX systems Panasonic KX-TDA to the computer with USB cable. Install the USB driver ver. 2.0.0.7 first and then TSP driver KX-TDA last version on the computer on OS Windows not later than XP, according to the instructions pointed above. Set it to receive TAPI througt USB. Check its efficiency.
  3. Download the Blitz KXTD TAPI Server installations Setup_Blitz_KXTD_TAPI_Server.zip.
  4. Run the program of installation Setup_Blitz_KXTD_Server_TAPI.exe and following instructions.
  5. Run Blitz_KXTDServConsole.exe. Set parameters for connection to Date Base Server and another setting of Blitz KX-TD TAPI Server.

1.6.2 Installation steps for Panasonic KX-TDA100/200/600 systems using CTI-link card Panasonic KX-TDA0410:

  1. Download TSP driver for KX-TDA systems, as well as instruction for their installation (PanasonicTSP-eula.pdf, KXTDATSPInstManual.pdf, panasonic_kx-tda_tsp_inst2117.zip).
  2. Install CTI-link card into PBX systems Panasonic KX-TDA100/200/600 and set it IP network adress. Connect CTI-link card to the Ethernet network with patchcord cable.
  3. Install TSP driver KX-TDA last version on the computer on OS Windows not later than XP, according to the instructions pointed above. Set it to receive TAPI througt IP adress of CTI-link card and default port 33333. Check its efficiency.
  4. Download the Blitz KXTD TAPI Server installations Setup_Blitz_KXTD_TAPI_Server.zip.
  5. Run the program of installation Setup_Blitz_KXTD_Server_TAPI.exe and following instructions.
  6. Run Blitz_KXTDServConsole.exe. Set parameters for connection to Date Base Server and another setting of Blitz KX-TD TAPI Server.