CTI Server

The CTI server configuration options can be found in the web-interface under the services tab.

General Options

The general options allow the administrator to manage network connections between the CTI server and the clients.

The section named STARTTLS options allows the administrator to enable encrypted communications between the clients and xivo-ctid and specify the certificate and private keys to use.

If no certificate and private key is configured, xivo-ctid will use the ones located in /usr/share/xivo-certs.

../../_images/starttls_options.png

Parting options are used to isolate XiVO users from each other. These options should be used when using the same XiVO for different enterprises.

Context separation is based on the user’s line context. A user with no line is not the member of any context and will not be able to do anything with the CTI client.

Note

xivo-dird must be restarted to take into account this parameter.

../../_images/cti_others.png

Authentication

xivo-ctid uses xivo-auth to authenticate users. The default authentication backend is xivo_user. To change the authentication backend, add a configuration file in /etc/xivo-ctid/conf.d with the following content:

auth:
    backend: backend_name

where backend name is the name of an enabled xivo-auth Backends Plugins.

Presence Option

In the Status menu, under Presences, you can edit presences group. The default presence group is francais. When editing a group, you will see a list of presences and their descriptions.

../../_images/presence_list.png

To use another presence group, you can edit the CTI profile you are using and select the appropriate presence group for that profile.

../../_images/presence_by_profile.png

Available configuration

  • Presence name is the name of the presence

  • Display name is the human readable representation of this presence

  • Color status is not relevant

  • Other reachable statuses is the list of presence that can be switched from this presence state

  • Actions are post selection actions that are triggered by selecting this presence

../../_images/presence_configuration.png

Actions

action

param

Enable DND

{‘true’,’false’}

Pause agent in all queues

Unpause agent in all queues

Agent logoff

Enable encryption

To enable encryption of CTI communications between server and clients, you have to enable STARTTLS in CTI Server ‣ General settings ‣ General

Custom certificates can be added in Configuration ‣ Certificates and used in CTI Server ‣ General settings ‣ General

In your XiVO Client, in the menu XiVO Client ‣ Configure ‣ Connection, click on the lock icon.

Note

A client which chooses to use encryption will not be able to connect to a server that does not have STARTTLS enabled.

Warning

For now, there is no mechanism for strong authentication of the server. The connection is encrypted, but the identity of the server is not verified.

CTI profiles

The CTI profiles define which features are made available to a user. You can configure which profile will be used by a user in the menu IPBX ‣ PBX Settings ‣ Users:

../../_images/user_profile.png

You can also customize the default profiles or add new profiles in the menu CTI Server ‣ Profiles:

../../_images/profiles_list.png