Web interface

The XiVO Centralized Interface (XCI) is managed through a web interface. In the following sections, we will highlight the main features of the system.

Definitions

XCI uses a few concepts that are important to understand in order to use the interface correctly.

XiVO
The XiVOs servers that are managed by XCI. XCI will automatically retrieve the entities and the users from them and apply the configuration to them.
Entity
Entities, also called Contexts, are the parts of the dialplan. Users are attached to them.
Line template
Line templates are used to quickly create users : they define a few default options (ringing time, voice mail, etc.) that will be applied to the new user. A line template is required to create a user.
User
Actual users that are associated with a phone number
Administrators
Users that are able to connect to the XCI and manage the XiVOs.

Dashboard

../_images/dashboard.png

The dashboard provides you some insights about your XiVO systems.

The left sidebar, displayed in every page of the application, gives you access to the various actions you can perform. The list of the configured XiVOs and their entities is shown to give a quick access to the one you want to manage.

XiVO

Create XiVO

../_images/xivo_create.png

This page allows you to add a new XiVO that will be managed by XCI. The first step is to add the displayed SSH key to the authorized keys of your XiVO server. This will allow XCI to connect and configure the XiVO server. You could do this kind of command :

echo 'ssh-rsa TheVeryLongSSHKeyYouCopied toto@someserver' | ssh root@xivoIp 'cat >> .ssh/authorized_keys'

Then, you have to provide the following informations :

  • Name : name of the XiVO server that will be displayed in XCI
  • Hostname : hostname or IP address of the XiVO server

You then have two options :

  • Create the XiVO and configure it now : XCI will save the informations, try to connect to the XiVO server and perform the configuration. XiVO services will be unavailable during the operation.

Warning

The configuration takes a while. Relax, go drink a coffee, XCI is doing the legwork for you :)

  • Create the XiVO without configuring it : XCI will only save the informations.

View XiVO

../_images/xivo_view.png

On the sidebar, each XiVO has its own View XiVO link. This page allows you to :

  • Add a new entity to this XiVO by clicking on the green button

  • See the entities associated to this XiVO and perform some operations to them :
    • Edit one by clicking on the yellow button with the wrench icon
    • Delete one by clicking on the red button with the trash icon

Entity

Create entity

../_images/entity_create.png

This page allows you to add a new entity to a XiVO. You have to provide the following informations :

  • Name : name that will be used by the XiVO server

  • Display name : name that will be displayed on XCI

  • Caller ID : phone number that will be displayed on outgoing call from this entity

  • Intervals : ranges of phone numbers that will be available to this entity. For each one, provide :

    • Start
    • End

    The system will return an error if the intervals overlap with other entities

View entity

../_images/entity_view.png

On the sidebar, each entity has its own link. This page allows you to :

  • Add a new user to this entity by clicking on the green button

  • Edit the entity by clicking on the yellow button with the wrench icon

  • See the users associated to this entity and perform some operations to them :
    • Edit one by clicking on the yellow button with the wrench icon
    • Delete one by clicking on the red button with the trash icon. At first click, the icon turns into a question mark. You have 5 seconds to click again to launch user deletion. This process prevents you from accidentally delete users.

Edit entity

../_images/entity_edit.png

This page allow you to modify an entity. Please refer to the Create entity section for fields details.

Line templates

List templates

../_images/template_list.png

On the sidebar, Line template has its own link. This page allows you to :

  • Add a new line template by clicking on the green button

  • See all the line templates and perform some operations to them :
    • Edit one by clicking on the yellow button with the wrench icon
    • Delete one by clicking on the red button with the trash icon

Create template

../_images/template_create.png

This page allows you to add a new line template. You have to provide the following informations :

  • Name : name that will be be displayed on XCI

  • XiVO : select the XiVOs for which this template will be available

  • Entity : select the entities for which this template will be available. Only entities of the selected XiVOs are displayed

  • SIP peer name : Auto or Model

  • Ringing time : number of seconds before incoming call is rejected

  • Routed :

    • The text field allows you to provide the SDA prefix to call the phone
    • Uncheck the checkbox if you don’t want the phone to be called from the outside
  • Outgoing caller id : specify what number is displayed on outgoing call. Possible values are :

    • External number prefix
    • Anonymous
    • Customized : a text field appears to provide the custom number
  • Voicemail :

    • Activate voicemail : enable or not the voicemail

    • Voicemail number : specify what number is used to call the voice mail. Possible values are :

      • Short line number : use the default short number
      • Customized : a text field appear to provide the custom number
    • Voice to mail : whether or not to send an email when a new message is left

Edit template

../_images/template_edit.png

This page allows you to modify a template. Please refer to the Create template section for fields details.

User

Create user

../_images/user_create.png

This page allows you to add a new user to an entity. You have to provide the following informations :

  • Template : line template to use as a template to create the user. The main options of the template are displayed below
  • First name
  • Last name
  • Internal number : number that will be used to internally call the user. Only the available numbers are displayed
  • CTI credentials : provide a login and a password to allow the user to connect through CTI interfaces

Edit user

../_images/user_edit.png

This page allows you to modify a user. Please refer to the Create user section for fields details.

Administrators

List administrators

../_images/administrator_list.png

On the sidebar, Administrators has its own link. This page allows you to :

  • Add a new administrator by clicking on the green button

  • See all the administrators and perform some operations to them :
    • Edit one by clicking on the yellow button with the wrench icon
    • Delete one by clicking on the red button with the trash icon

Create administrator

../_images/administrator_create.png

This page allows you to add a new administrator. You have to provide the following informations :

  • Login : login used by the administrator to connect to XCI
  • Name : name that will be displayed on XCI
  • LDAP : if checked, the LDAP authentication configured in application.conf will be used
  • Password : password used by the administrator to connect to XCI. Shown only if LDAP disabled
  • Superadmin : whether or not this administrator is a super-administrator. Super-administrators can manage everything in XCI
  • Entities : select the entities this administrator will be able to manage Shown only if Superadmin disabled

Edit administrator

../_images/administrator_edit.png

This page allows you to modify an administrator. Please refer to the Create administrator section for fields details.