KalliopeCTI

N.B.: The KalliopeCTI 4 version 4.5.23 manual for the client installation and configuration is available here.

To download the client for your operating system, visit www.kalliopbx.com and go to section Download --> Applications

Introduction

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	KCTI 4 Mobile
-
Extension phonebook	✓	✓	✓	✓
Shared phonebook	✓	✓	✓	✓
CDR	✓	✓	✓	✓
Click-to-call	✓	✓	✓	✓
Inbound call notification	✓	✓	✓	✓
Instant Messaging	✓	✓	✓	✓
Presence	✓	✓	✓	✓
Opening custom URLs	✓	✓	✓	-
Voicemail access	✓	✓	✓	✓
Copy-to-call	✓	✓	✓	-
Synchronization with Outlook contact	-	✓	✓	-
BLF	-	✓	✓	✓
Number dialing	-	✓	✓	✓
Blind transfer	-	✓2	✓	✓
Attended transfer	-	✓2	✓	✓
Do not Disturb	-	✓2	✓	-
Call recording	-	✓2	✓	-
Unconditional forward	-	✓2	✓	-
Call parking	-	✓2	✓	-
Call pickup	-	✓2	✓	-
Forking to Mobile	-	✓2	✓	✓
Queue statistics	✓2	✓2	✓2	-
Supervisor mode	✓2	✓2	✓2	-
Selective pause	✓2	✓2	✓2	-
Touchscreen support	-	-	-	✓
Mobile phonebook integration	-	-	-	✓

¹Available only when paired with a Snom or Yealink phone
²Available 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:

Whindows:

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

Mac:

• macOS 10.15, 10.14, 10.13
• recommended: Apple hardware from 2013 or later

Linux:

• Ubuntu 16.04 64bit or Ubuntu 18.04 64bit

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

NOTA: Nel caso in cui il servizio SIP della centrale sia esposto su un IP diverso da quello di connessione CTI, o su una porta diversa da quella standard (5060) è necessario impostare sul KalliopePBX uno o entrambi i seguenti placeholder personalizzati all'interno del pannello di Provisioning: %%_KPHONE_SIP_REGISTRAR_IP%% e %%_KPHONE_SIP_REGISTRAR_PORT%% . Questa configurazione è normalmente necessaria quando il servizio SIP viene esposto al pubblico tramite un Session Border Controller che utilizza un IP diverso da quello su cui è raggiungibile la centrale, mentre è non necessario se PBX e SBC sono nattati sullo stesso IP pubblico, ciascuno per le porte di sua competenza (TCP/5039 e TCP/5222 per le componenti CTI e Chat, verso Kalliope, e SIP + RTP per la fonia, verso l'SBC).

User Manual

The KalliopeCTI 4 manual for version 4.5.6 and the installation and configuration of the cient is available here.

Parametri speciali del file INI del KalliopeCTI

A partire dalla 4.5.18 del KalliopeCTI possono essere aggiunti o modificati direttamente nel kcti.ini i seguenti parametri. Nella tabella seguente sono riportati i parametri modificabili con indicata la versione del KalliopeCTI a partire dalla quale il parametro è presente e modificabile.

Parametro	Valore di esempio	Descrizione	A partire da (versione KCTI Desktop)
echoCanceller	on	per abilitare (on) o meno (off) l'echo cancel. Default: on	4.5.23
echoCancellerLmsFilter	off	Per abilitare (on) o meno (off) il filtro LMS sull'echo cancel. Default: off	4.5.23
echoSuppressor	on	Per abilitare (on) o meno (off) l'echo suppression. Default: on	4.5.23
suppressorLowerThreshold	10	Per impostare la soglia minima (percentuale) dell'echo suppression. Range valori ammessi: [0, 100]. Default: 10	4.5.23
suppressorUpperThreshold	40	Per impostare la soglia massima (percentuale) dell'echo suppression. Range valori ammessi: [0, 100]. Default: 40	4.5.23
suppressorDivider	15	Per impostare il divisore dell'echo suppression. Range valori ammessi: [2, 50]. Default: 15	4.5.23
suppressorConvergenceMillis	4000	Per impostare la convergenza (millisecondi) dell'echo suppression. Range valori ammessi: [1000, 120000]. Default: 4000	4.5.23
chatKeepAliveSendIntervalSecs	120	per i messaggi di ping XMPP, default 2 minuti	4.5.19
contactsRefreshTimeoutSecs	600	per l'aggiornamento del phonebook, default 10 minuti	4.5.18
cdrRefreshTimeoutSecs	90	per l'aggiornamento del cdr/voicemail, default 1 minuto e mezzo	4.5.18
identitiesRefreshTimeoutSecs	300	per l'aggiornamento degli account, default 5 minuti	4.5.18
queueStatsRefreshTimeoutSecs	300	per l'aggiornamento delle code, default 5 minuti	4.5.18
codecOrderRefreshTimeoutSecs	30	per l'aggiornamento dei codec, default 30 secondi	4.5.18
excludedOutlookFolders	Cartelle pubbliche;Public folders;Cache;Lync;Skype	elenco stringhe contenute nelle folders di Outlook da escludere comprese le relative subfolders dall'import dei contatti, come separatore va usato il ;	4.5.18
queueNames	Coda1;Coda2	elenco dei nomi esatti delle code da visualizzare nel Supervisor Panel, come separatore va usato il ;	4.5.15

kcti.ini si trova nella stessa directory dei trace (quindi AppData\Roaming\KCTI4 sotto il percorso d'utente).

Si ricorda poi che il kcti.ini va modificato manualmente quando il Kcti non è in esecuzione.

API

Il client mette a disposizione all'utente delle API per poter effettuare delle azioni in maniera programmatica senza l'utilizzo dell'interfaccia grafica.
Le azioni disponibili sono:

• chiamare un numero
• chiudere la chiamata corrente
• trasferire con o senza offerta di una chiamata in corso
• mettersi/togliersi dalla pausa su tutte le code
• abilitare/disabilitare il DND
• recuperare i dati della chiamata attiva

Per le versioni dalla 4.5.0 in su è disponibile una collection Postman per testare le API del KalliopeCTI client scaricabile dal seguente link: KalliopeCTI Client (vers.4.5.x) postman collection È possibile inoltre scaricare in formato pdf un manuale operativo delle API del Kalliope CTI client dal questo link.