Da KalliopePBX.
Questa pagina è una versione tradotta della pagina KalliopeCTI; la traduzione è completa al 100 %.

Altre lingue:
English • ‎italiano

The KalliopeCTI 4 manual for version 4.3.x is available here.


KalliopeCTI 4 (or KCTI 4) is an accessory application of the KalliopePBX V4 VoIP PBX that helps you use its services and access information.

KCTI 4 (available in Free, Pro, and Phone modes) is a cross-platform application on Windows, Mac OS X, and Ubuntu. A KCTI 4 Pro or Phone license includes a license for the KCTI Mobile app for Android and iOS.

The KalliopeCTI Mobile user manual can be found here.

The following table lists the features available with each mode.

KCTI 4 Free
KCTI 4 Pro
KCTI 4 Phone
Extension phonebook
Shared phonebook
Inbound call notification
Instant messaging
CTI presence
Automatic actions
Voicemail access
Queue statistics
Supervisor panel
Blind transfer
Attended transfer
Do Not Disturb
Call recording
Unconditional forward
Call parking
Call pickup
Pickup with invite
Fork to Mobile

1Available only when paired with a Snom or Yealink phone
2Available only when paired with Kalliope Call Center

Download and installation

KCTI 4 can be downloaded for free from the download page of the official KalliopePBX website.

The user can then go to the configuration page to select which version to open each time (as long as the corresponding license has been activated on KalliopePBX V4). KCTI Free, Pro, or Phone are different modes of the same software.

N.B.: Installation does not prompt for any activation keys. Instead, the application will automatically check for the correct license on KalliopePBX every time it is opened.

Unlike KCTI 4 Free, KCTI 4 Pro and Phone require a specific license to be activated on KalliopePBX V4 for each workstation. The KCTI 4 Phone license also includes KCTI 4 Pro. The user can choose their desired mode from the configuration page.

For instructions on how to activate the KCTI 4 Pro or KCTI 4 Phone licenses, see the licenses page.

System requirements:

  • Windows 7 or later
  • Sound card (for KCTI Phone)
  • 2 GB of RAM
  • 100 MB of free disk space

To install the application on Windows, simply open the executable file and follow the instructions.


When you first open the application, you will see a message prompting you to insert the configuration parameters.


You will then be taken to the configuration page. The settings are grouped by category.

Configuraton page

Application mode

In this tab you can select which mode to use: KCTI 4 Free, KCTI 4 Pro, or KCTI 4 Phone. You can also choose the language (English, Italian, Spanish).

KCTI settings

In this tab you can configure the following settings:

  • KalliopePBX IP address: the IP address of the KalliopePBX the application should connect to
  • KCTI username: the name assigned to the user
  • KCTI password: the password assigned to the user

N.B.: The username and password are the same as the credentials on the System -> Users managements page on KalliopePBX V4.

KCTI services

In this tab you can configure the following settings:

  • Copy-to-call: enables/disables copy-to-call. When enabled, the user can make a call simply by selecting the string containing the number and copying it to the clipboard (in Windows you can do this with CTRL+C). Once the number has been copied, the application will automatically strip spaces and other special characters (# + , : () . /\) and ask the user for confirmation before making the call.
  • Import Microsoft Outlook contacts: if selected, KCTI will automatically sync with Microsoft Outlook contacts when opened. The imported contacts will appear in the phonebook marked by an icon.
  • Open minimized as system icon: if selected, the application will open in minimized mode.
  • Enable call reception popup: enables or disabled the call reception popup.
  • Pause on all queues upon logout
  • Pause on all queues upon answering a call from the queue
  • Enable automatic updates: automatically download available KalliopeCTI 4 updates

Phone integration

In KCTI 4 Pro mode, you can remotely control a linked phone through native APIs. This feature is currently only available on Snom or Yealink phones.

Account list

This tab shows all accounts linked to the user, listing the brands, models, firmware, and MAC addresses of each one. It is up to the user to select which accounts to link to KalliopeCTI.

Automatic actions

Automatic actions

In this tab you can manage the behavior of the application during inbound calls by configuring actions triggered by the following events:

  • Arrival of call: the action will be executed when the phone begins to ring
  • Answering call: the action will be executed when the user answers a call
  • End of call: the action will be executed when the call is terminated, either by the local user or by the remote one

For each of these events, you can choose one or more actions of two types:

  • Open a custom URL
  • Execute an external process

In both cases you can use the following dynamic parameters:

  • <callername>: this parameter will be replaced by the name assigned to the caller if present in the phonebook
  • <callernum>: this parameter will be replaced by the number of the caller
  • <extenNum>: this parameter will be replaced by the extension number of the local user
  • <uid>: this parameter will be replaced by a unique call ID.

The figure to the side shows the automatic event configuration tab. The table on the top part of the tab contains the list of configured actions, showing the type of event ("IN" = arrival of call, "RIS" = answering call, "FIN" = end of call), the action type ("EXE" = execute an external process, "URL" = open a dynamic URL), and the action details.

Once the action has been saved, you can always edit or delete it by selecting it and clicking on Edit action/Delete action. For each action you can indicate whether it must be executed only on calls from external users or on calls between extensions as well, and whether or not it must also be executed on outbound calls.

Softphone settings

This tab is only available in KCTI 4 Phone mode and lets you select the audio device to use for audio input (microphone), audio output (to listen to the call), and for notifications (audio output for the ringtone and other notifications).

User Manual

The KalliopeCTI 4 user manual is available in pdf format at this link.