Differenze tra le versioni di "KalliopeCTI/en"

Versione attuale delle 10:32, 5 set 2022

Altre lingue:

English
italiano

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.kalliope.com, menu Support --> Downloads and then Applications

Introduction

KalliopeCTI 4 (or KCTI 4) is an accessory application of the KalliopePBX V4 VoIP 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	-	✓²	✓	✓
Attended transfer	-	✓²	✓	✓
Do not Disturb	-	✓²	✓	-
Call recording	-	✓²	✓	-
Unconditional forward	-	✓²	✓	-
Call parking	-	✓²	✓	-
Call pickup	-	✓²	✓	-
Forking to Mobile	-	✓²	✓	✓
Queue statistics	✓²	✓²	✓²	-
Supervisor mode	✓²	✓²	✓²	-
Selective pause	✓²	✓²	✓²	-
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:

Windows:

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

MAC:

macOS: BigSur (11.0), Catalina (10.15), Mojave (10.14)
recommended: Apple hardware from 2013 or later

Linux:

Ubuntu 18.04 or 20.04

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

NOTE: In case the SIP service of the central unit is exposed on a different IP from the CTI connection one, or on a different port from the standard one (5060) it is necessary to set on the KalliopePBX one or both of the following custom placeholders inside the Provisioning panel: %%_KPHONE_SIP_REGISTRAR_IP%% and %%_KPHONE_SIP_REGISTRAR_PORT%%% . This configuration is normally necessary when the SIP service is exposed to the public through a Session Border Controller that uses a different IP from the one on which the PBX is reachable, while it is not necessary if the PBX and the SBC are NATed on the same public IP, each one for the ports of its competence (TCP/5039 and TCP/5222 for the CTI and Chat components, towards Kalliope, and SIP + RTP for voice, towards the SBC).

User Manual

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

Special parameters of the KalliopeCTI INI file

Starting from 4.5.18 of KalliopeCTI the following parameters can be added or modified in kcti.ini. The following table shows the editable parameters with the version of KalliopeCTI from which the parameter is present and editable.

Parameter	Example Value	Description	Starting from (version KCTI Desktop)
`echoCanceller`	`on`	to enable (`on`) or disable (`off`) the echo cancel. Default: `on`	4.5.23
`echoCancellerLmsFilter`	`off`	To enable (`on`) or disable(`off`) the echo caneller LMS filter. Default: `off`	4.5.23
`echoSuppressor`	`on`	To enable (`on`) or disable (`off`) the echo suppression. Default: `on`	4.5.23
`suppressorLowerThreshold`	10	To set the lower threshold (percentage) of echo suppression. Allowed value range: [0, 100]. Default: 10	4.5.23
`suppressorUpperThreshold`	40	To set the highest threshold (percentage) of echo suppression. Allowed value range: [0, 100]. Default: 40	4.5.23
`suppressorDivider`	15	To set the echo suppressor divider. Allowed value range: [2, 50]. Default: 15	4.5.23
`suppressorConvergenceMillis`	4000	To set the echo suppressor convergence (millis). dell'echo suppression. Allowed value range: [1000, 120000]. Default: 4000	4.5.23
`chatKeepAliveSendIntervalSecs`	120	To XMPP ping messages, default 2 minutes	4.5.19
`contactsRefreshTimeoutSecs`	600	To the contacts refresh, default 10 minutes	4.5.18
`cdrRefreshTimeoutSecs`	90	To cdr/voicemail refresh, default 1 minutes and 30 seconds	4.5.18
`identitiesRefreshTimeoutSecs`	300	To identities refresh, default 5 minutes	4.5.18
`queueStatsRefreshTimeoutSecs`	300	To queue stats refresh, default 5 minutes	4.5.18
`codecOrderRefreshTimeoutSecs`	30	To codec order refresh, default 30 seconds	4.5.18
`excludedOutlookFolders`	`Public folders;Cache;Lync;Skype`	list of strings contained in the Outlook folders to be excluded. Including the relative subfolders from contacts imports. As a separetor you can use `;`	4.5.18
`queueNames`	`Queue1;Queue2`	list of the queue names to be displayed in the Supervisor panel. As a sepaetor you can use `;`	4.5.15

kcti.ini is located in the same directory of the traces (AppData\Roaming\KCTI4 under the user path).

n.b. kcti.ini must be edited manually when Kcti is not running.

API

The client provides the user with APIs to perform actions without the use of the graphic interface.
The available actions are:

To call a number
To close the current call
To transfer with/without an offert the call in progress
To pause/unpause on all queues
To enable/disable DND
Retrieve the data of the active call

For versions 4.5.0 and up a Postman collection is available to test the API of the KalliopeCTI client. You can download it from this 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.

Differenze tra le versioni di "KalliopeCTI/en"

Versione attuale delle 10:32, 5 set 2022

Indice

Introduction

Download and installation

User Manual

Special parameters of the KalliopeCTI INI file

API

Menu di navigazione

Ricerca

@@ Riga 1: / Riga 1: @@
 <languages />
 <div class="noutonum" style="float: right">__TOC__</div>
+<br>
+<big>'''N.B.''': The KalliopeCTI 4 version 4.5.23 manual for the client installation and configuration is available  [http://www.kalliopepbx.com/it/download/manualistica?download=90:kalliopecti-4-manuale-utente here].
+To download the client for your operating system, visit www.kalliope.com, menu Support --> Downloads and then Applications </big>
 ==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.
+KalliopeCTI 4 (or KCTI 4) is an accessory application of the KalliopePBX V4 VoIP that helps you use its services and access information.
-KCTI 4 (nelle versioni “Free”, “Pro” e “Phone”) è disponibile per sistemi operativi Windows e macOS. Con l’acquisto di ogni licenza KCTI 4 Pro e Phone è inclusa una licenza KCTI Mobile per l’utilizzo dell’app mobile KCTI su dispositivi Android.
+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.
-Il manuale utente dell’app KalliopeCTI mobile è disponibile al seguente [http://www.kalliopepbx.com/wiki/it/Kalliope_CTI_Mobile link].
+The KalliopeCTI Mobile user manual can be found [[Kalliope_CTI_Mobile/en|here]].
-Di seguito riassumiamo la lista delle principali funzionalità delle diverse versioni.
+The following table lists the features available with each mode.
 {| class="wikitable"
 |-
-! <div style = 'text-align: left; color: transparent> - !! '''KCTI 4 Free''' !! <div style = 'text-align: left> '''KCTI 4 Pro''' !! <div style = 'text-align: left> '''KCTI 4 Phone'''
+! <div style = 'text-align: left; color: transparent> - !! '''KCTI 4 Free''' !! <div style = 'text-align: left> '''KCTI 4 Pro''' !! <div style = 'text-align: left> '''KCTI 4 Phone'''!! <div style = 'text-align: left> '''KCTI 4 Mobile'''
 |-
 |colspan="4"| <div style = 'text-align: center; color: transparent> -
 |-
-| Rubrica interni||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
+| Extension phonebook||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
+|-
+| Shared phonebook||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
+|-
+| CDR||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
+|-
+| Click-to-call ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
 |-
-| Rubrica condivisa||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
+| Inbound call notification||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
 |-
-| CDR||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
+| Instant Messaging|| <div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
 |-
-| Click-to-call ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
+| Presence || <div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
 |-
-| Notifica chiamate in ingresso||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
+| Opening custom URLs||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> -
 |-
-| Instant Messaging|| <div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
+| Voicemail access ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
 |-
-| Presence CTI|| <div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
+| Copy-to-call||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> -
 |-
-| Azioni automatiche||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
+| Synchronization with Outlook contact||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> -
 |-
-| Accesso voicemail ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
+| BLF||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
 |-
-| Copy-to-call||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
+| Number dialing||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
 |-
-| Drop-to-call||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
+| Blind transfer||<div style = 'text-align: center'>  - ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup>  ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
 |-
-| BLF||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
+| Attended transfer||<div style = 'text-align: center'>  - ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup>  ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
 |-
-| Statistiche code di attesa||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup> ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup>
+| Do not Disturb||<div style = 'text-align: center'>  - ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup>  ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'>  -
 |-
-| Supervisor Panel||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup> ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup>
+| Call recording||<div style = 'text-align: center'>  - ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup>  ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'>  -
 |-
-| Trasferimento senza offerta||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓<sup><small>1</small></sup> ||<div style = 'text-align: center'> ✓
+| Unconditional forward||<div style = 'text-align: center'>  - ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup>  ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'>  -
 |-
-| Trasferimento con offerta||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓<sup><small>1</small></sup> ||<div style = 'text-align: center'> ✓
+| Call parking||<div style = 'text-align: center'>  - ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup>  ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'>  -
 |-
-| Do Not Disturb||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓<sup><small>1</small></sup> ||<div style = 'text-align: center'> ✓
+| Call pickup||<div style = 'text-align: center'>  - ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup>  ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'>  -
 |-
-| Registrazione chiamata||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓<sup><small>1</small></sup> ||<div style = 'text-align: center'> ✓
+| Forking to Mobile||<div style = 'text-align: center'>  - ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup>  ||<div style = 'text-align: center'> ✓ ||<div style = 'text-align: center'> ✓
 |-
-| Inoltro incondizionato||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓<sup><small>1</small></sup> ||<div style = 'text-align: center'> ✓
+| Queue statistics||<div style = 'text-align: center'> ✓<sup><small>2</small></sup> ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup> ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup> ||<div style = 'text-align: center'> -
 |-
-| Parcheggio chiamata||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓<sup><small>1</small></sup> ||<div style = 'text-align: center'> ✓
+| Supervisor mode||<div style = 'text-align: center'> ✓<sup><small>2</small></sup> ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup> ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup> ||<div style = 'text-align: center'> -
 |-
-| Prelievo chiamata||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓<sup><small>1</small></sup> ||<div style = 'text-align: center'> ✓
+| Selective pause||<div style = 'text-align: center'> ✓<sup><small>2</small></sup> ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup> ||<div style = 'text-align: center'> ✓<sup><small>2</small></sup> ||<div style = 'text-align: center'> -
 |-
-| Prelievo con invito||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓<sup><small>1</small></sup> ||<div style = 'text-align: center'> ✓
+| Touchscreen support||<div style = 'text-align: center'>  - ||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓
 |-
-| Forking to Mobile||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓<sup><small>1</small></sup> ||<div style = 'text-align: center'> ✓
+| Mobile phonebook integration||<div style = 'text-align: center'>  - ||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> - ||<div style = 'text-align: center'> ✓
 |}
-<sup><small>1</small></sup>Disponibile solo in abbinamento con un telefono Snom o Yealink <br>
+<sup><small>1</small></sup>Available only when paired with a Snom or Yealink phone<br>
-<sup><small>2</small></sup>Disponibile solo in abbinamento con il modulo Kalliope Call Center
+<sup><small>2</small></sup>Available only when paired with Kalliope Call Center
-==Download e installazione==
+==Download and installation==
-KCTI 4 è scaricabile liberamente dall'[http://www.kalliopepbx.com/it/download/applicazioni area download] del sito ufficiale di KalliopePBX.
+KCTI 4 can be downloaded for free from the [http://www.kalliopepbx.com/en/download/applications download page] of the official KalliopePBX website.
-Tramite il Pannello di Configurazione sarà cura dell’utente selezionare quale modalità di utilizzo attivare di volta in volta, previa verifica della disponibilità sul centralino KalliopePBX V4 della relativa licenza. Per questo motivo KCTI 4 Free, Pro e Phone non sono altro che tre modalità applicative dello stesso software.
+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.
-'''Nota''': L’installazione non prevede l’inserimento di alcun codice di attivazione. L’applicazione verifica in automatico la presenza sul centralino KalliopePBX della corretta licenza di utilizzo a ciascun avvio.
+'''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.
-Ad eccezione della modalità applicativa KCTI 4 Free, che non richiede alcuna licenza, KCTI 4 Pro e Phone richiedono l’installazione sul centralino KalliopePBX V4 di una specifica licenza per ciascuna postazione. La licenza per KCTI 4 Phone consente di utilizzare anche la modalità applicativa KCTI 4 Pro. Dal pannello di Configurazione, l’utente ha la possibilità di selezionare la modalità applicativa desiderata.
+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.
-Per la procedura di configurazione delle licenze KCTI 4 Pro o KCTI 4 Phone sul centralino KalliopePBX V4 si faccia riferimento alla sezione [[AdminGuide:GUI:OperatingMenu:Licenses|Licenze]].
+For instructions on how to activate the KCTI 4 Pro or KCTI 4 Phone licenses, see the [[AdminGuide:BasicConcepts:Licenses/en|licenses]] page.
-'''Requisiti di Sistema''':
+'''System requirements''':
-*Sistema operativo Windows 7 o successivo
-*Scheda audio presente (per la modalità KCTI Phone)
-*2 GB di RAM
-*100 MB di spazio per l’installazione
-Per installare l’applicazione in ambiente Windows è sufficiente lanciare l’eseguibile e seguire le istruzioni.
+Windows:
+*Windows 8 or later
+*Sound card (for KCTI Phone)
+*2 GB RAM
+*100 MB of free disk space
+MAC:
+*macOS: BigSur (11.0), Catalina (10.15), Mojave (10.14)
+*recommended: Apple hardware from 2013 or later
+Linux:
+*Ubuntu 18.04 or 20.04
-==Configurazione==
+To install the application on Windows, simply open the executable file and follow the instructions.
-Al primo avvio dell’applicazione comparirà un messaggio che segnala la necessità di inserire i parametri di configurazione.
-[[File:Notifica.png|450x113px|centro]]
+'''NOTE:''' In case the SIP service of the central unit is exposed on a different IP from the CTI connection one, or on a different port from the standard one (5060) it is necessary to set on the KalliopePBX one or both of the following custom placeholders inside the Provisioning panel: '''%%_KPHONE_SIP_REGISTRAR_IP%%''' and '''%%_KPHONE_SIP_REGISTRAR_PORT%%%''' . This configuration is normally necessary when the SIP service is exposed to the public through a Session Border Controller that uses a different IP from the one on which the PBX is reachable, while it is not necessary if the PBX and the SBC are NATed on the same public IP, each one for the ports of its competence (TCP/5039 and TCP/5222 for the CTI and Chat components, towards Kalliope, and SIP + RTP for voice, towards the SBC).
-Successivamente si aprirà automaticamente la schermata di configurazione. Il menu di configurazione è raggruppato per categorie funzionali, ciascuna delle quali dispone di uno o più parametri configurabili.
+== User Manual==
-[[File:Impostazionicti.png|368x439px|destra|miniatura||Schermata di configurazione]]
+The KalliopeCTI 4 manual for version 4.5.23 and the installation and configuration of the cient is available [https://www.kalliopepbx.com/it/download/manualistica?download=122:kalliopecti-4-5-15-manuale-utente here].
+==Special parameters of the KalliopeCTI INI file==
+Starting from '''4.5.18''' of KalliopeCTI the following parameters can be added or modified in '''kcti.ini'''. The following table shows the editable parameters with the version of KalliopeCTI from which the parameter is present and editable.
-===Modalità applicativa===
+{|class="wikitable"
-In questa sezione è possibile selezionare la modalità con cui si vuole che venga eseguita l’applicazione: KCTI 4 Free, KCTI 4 Pro oppure KCTI 4 Phone. Inoltre è possibile selezionare la lingua (Italiano, Inglese o Spagnolo).
+! Parameter
+! Example Value
-===Impostazioni KCTI===
+! Description
-I parametri configurabili in questa sezione sono i seguenti:
+! Starting from (version KCTI Desktop)
-*Indirizzo IP KalliopePBX: l’indirizzo IP assegnato al centralino KalliopePBX a cui si desidera connettersi
+|-
-*Username KCTI: il nome utente assegnato
+| <code>echoCanceller</code>
-*Password KCTI: la password associata all’utente.
+| <code>on</code>
+| to enable (<code>on</code>) or disable (<code>off</code>) the echo cancel. Default: <code>on</code>
-'''Nota''': Username e password corrispondono alle credenziali configurabili sul centralino KalliopePBX V4 nel pannello ''Sistema'' → ''Gestione degli utenti''
+| 4.5.23
+|-
-===Servizi KCTI===
+| <code>echoCancellerLmsFilter</code>
-I parametri configurabili in questa sezione sono i seguenti:
+| <code>off</code>
-*Servizio Copy-to-Call: permette l’abilitazione/disabilitazione del servizio Copy-to-Call. Se abilitato è possibile richiedere l’avvio di una chiamata semplicemente selezionando la stringa contenente il numero e copiandola nella clipboard (ad esempio in ambiente Windows usando la combinazione di tasti CTRL + V). Una volta copiata la stringa l’applicazione provvede in automatico a rimuovere spazi e altri caratteri speciali (# + , : () . /\) e chiede all’utente conferma prima di avviare la chiamata.
+| To enable (<code>on</code>) or disable(<code>off</code>) the echo caneller LMS filter. Default: <code>off</code>
-*Importa contatti Microsoft Outlook: se selezionato KCTI sincronizzerà automaticamente all’avvio i contatti Microsoft Outlook. I contatti importati appariranno nella rubrica contrassegnati dall’icona.
+| 4.5.23
-*Avvia minimizzato come icona di sistema: se selezionato fa sì che l’applicazione si avvii minimizzato come icona di sistema.
+|-
-*Abilita popup di ricezione chiamata: permette di abilitare o disabilitare il popup di notifica di ricezione chiamata.
+| <code>echoSuppressor</code>
-*Metti in pausa su tutte le code al logout
+| <code>on</code>
-*Metti in pausa su tutte le code alla risposta di una chiamata di coda
+| To enable (<code>on</code>) or disable (<code>off</code>) the echo suppression. Default: <code>on</code>
-*Abilita aggiornamenti automatici: scarica automaticamente ad ogni avvio gli aggiornamenti KalliopeCTI 4 disponibili.
+| 4.5.23
+|-
-===Integrazione telefono===
+| <code>suppressorLowerThreshold</code>
-In modalità KCTI 4 Pro è possibile pilotare l'apparato telefonico associato, tramite le API native. Questa funzionalità è disponibile, al momento, solo con telefoni Snom e Yealink.
+| 10
+| To set the lower threshold (percentage) of echo suppression. Allowed value range: [0, 100]. Default: 10
-===Lista account===
+| 4.5.23
-In questo riquadro vengono riportati tutti gli account associati all’utente con informazioni su marca, modello, firmware e MAC address dell’account. Sarà cura dell’utente selezionare l’account da associare a KalliopeCTI.
+|-
+| <code>suppressorUpperThreshold</code>
-===Azioni automatiche===
+| 40
-[[File:Azioniautom.png|368x550px|destra|miniatura||Azioni automatiche]]
+| To set the highest threshold (percentage) of echo suppression. Allowed value range: [0, 100]. Default: 40
+| 4.5.23
-In questo pannello è possibile gestire il comportamento sulle chiamate in ingresso attraverso la configurazione di azioni da innescare al verificarsi dei seguenti eventi:
+|-
-*Arrivo di una chiamata (equivalente allo squillo)
+| <code>suppressorDivider</code>
-*Risposta ad una chiamata: l’evento si innesca quando la chiamata in ingresso viene risposta
+| 15
-*Chiusura di una chiamata: l’evento si innesca quando la chiamata viene conclusa (sia dall’utente locale che da quello remoto)
+| To set the echo suppressor divider. Allowed value range: [2, 50]. Default: 15
+| 4.5.23
-A ciascuno di questi eventi è possibile associare una o più azioni automatiche che possono essere di due tipi:
+|-
-*Apertura di un URL personalizzato
+| <code>suppressorConvergenceMillis</code>
-*Esecuzione di un processo esterno
+| 4000
+| To set the echo suppressor convergence (millis).  dell'echo suppression. Allowed value range: [1000, 120000]. Default: 4000
+| 4.5.23
+|-
+| <code>chatKeepAliveSendIntervalSecs</code>
+| 120
+| To XMPP ping messages, default 2 minutes
+| 4.5.19
+|-
+| <code>contactsRefreshTimeoutSecs</code>
+| 600
+| To the contacts refresh, default 10 minutes
+| 4.5.18
+|-
+| <code>cdrRefreshTimeoutSecs</code>
+| 90
+| To cdr/voicemail refresh, default 1 minutes and 30 seconds
+| 4.5.18
+|-
+| <code>identitiesRefreshTimeoutSecs</code>
+| 300
+| To identities refresh, default 5 minutes
+| 4.5.18
+|-
+| <code>queueStatsRefreshTimeoutSecs</code>
+| 300
+| To queue stats refresh, default 5 minutes
+| 4.5.18
+|-
+| <code>codecOrderRefreshTimeoutSecs</code>
+| 30
+| To codec order refresh, default 30 seconds
+| 4.5.18
+|-
+| <code>excludedOutlookFolders</code>
+| <code>Public folders;Cache;Lync;Skype</code>
+| list of strings contained in the Outlook folders to be excluded. Including the relative subfolders from contacts imports. As a separetor you can use <code>;</code>
+| 4.5.18
+|-
+| <code>queueNames</code>
+| <code>Queue1;Queue2</code>
+| list of the queue names to be displayed in the Supervisor panel. As a sepaetor you can use <code>;</code>
+| 4.5.15
+|}
-In entrambi casi è possibile inserire nelle azioni i seguenti parametri dinamici:
+kcti.ini is located in the same directory of the traces (AppData\Roaming\KCTI4 under the user path).
-*<callername>: se presente in rubrica, questo parametro viene sostituito automaticamente con il nome associato al numero dell’interlocutore
-*<callernum>: questo parametro viene sostituito automaticamente con il nome associato al numero dell’interlocutore
-*<extenNum>: questo parametro viene sostituito automaticamente con numero di interno associato all’utente locale
-*<uid>: questo parametro viene sostituito automaticamente con un id univoco di chiamata
-In figura è riportata la schermata di configurazione degli eventi automatici. La tabella posta nella parte superiore del pannello contiene la lista delle azioni configurate, indicando per ciascuna di esse la tipologia di evento (“IN” = chiamata in arrivo, “RIS” = risposta ad una chiamata, “FIN” = chiusura di una chiamata), la tipologia di azione (“EXE” = esecuzione di un processo esterno, “URL” = apertura di un url dinamico) e il dettaglio dell’azione.
+<span class="underline"> n.b. kcti.ini must be edited manually when Kcti is not running.</span>
-Una volta salvata un’azione, è sempre possibile modificarla o eliminarla semplicemente selezionandola nella tabella e cliccando sull’apposito tasto (Modifica azione/Elimina azione).
-Per ciascuna azione è possibile indicare se deve essere applicata anche nel caso di chiamate tra interni o solo quando l’utente remoto è una utenza esterna e, inoltre, se deve essere applicata anche per le chiamate uscenti.
-===Impostazioni Softphone===
-Questo pannello è disponibile solo in modalità KCTI 4 Phone, e permette di modificare i device audio da utilizzare per il microfono (l’ingresso audio), per l’ascolto (l’uscita audio per ascoltare la conversazione) e per le notifiche (l’uscita audio per la suoneria e le altre notifiche).
-==Manuale Utente==
+==API==
-Il manuale utente KalliopeCTI 4 è disponibile in formato pdf al seguente [http://www.kalliopepbx.com/it/download/manualistica?download=90:kalliopecti-4-manuale-utente link].
+The client provides the user with APIs to perform actions without the use of the graphic interface.<br>
+The available actions are:
+* To call a number
+* To close the current call
+* To transfer with/without an offert the call in progress
+* To pause/unpause on all queues
+* To enable/disable DND
+* Retrieve the data of the active call
+For versions 4.5.0 and up a [https://www.postman.com/ Postman] collection is available to test the API of the KalliopeCTI client. You can download it from this link: [http://www.kalliopepbx.com/wiki/it/images/f/fb/KalliopeCTI_Client.postman_collection.zip 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 [http://www.kalliopepbx.com/wiki/kcti4_client_api_4.5.pdf link].