Skip to end of metadata
Go to start of metadata

Introduction

This document shows how to install and configure the BlueMind plugins that allow interconnexion with Avencall's XiVO.

On this page:

Related:

Configuring Xivo

  • create a Xuc user in Services -> IPBX -> Users
  • enable the Xivo client for this user using the following:
    • login: xuc
    • password: 0000
  • create a Web Services user in Configuration > Web Services Access using the following settings:

    • Login: xivows
    • Password: xivows
    • Host: empty
  • Make sure that Multiqueues call stats sharing is enabled in Services > Ipbx > Advanced configuration > Queues

Installing the XiVO plugin for BlueMind

Prerequisite

The XUC service must be installed on the Avencall server and set up on port 8090.

/etc/xuc/xuc.conf contents:

XivoWs {
    enabled=true
}
 
api {
    eventUrl = "http://<bluemind.srv.ip:9091/xivo/1.0/event/domain.tld/dropbox/"
}
 
xucami {
    enabled = false
}

Procedure

  1. Install the required packages:

    Debian/Ubuntu
     aptitude install bm-plugin-core-cti-xivo bm-xivobridge bm-plugin-webserver-cti
    RedHat/CentOS
    yum install bm-plugin-core-cti-xivo bm-xivobridge bm-plugin-webserver-cti

    In the case of a distributed installation, the bm-plugin-webserver-cti package must be installed on the server hosting the bm-webserver service.

  2. Once they are installed, restart BlueMind:

    # bmctl restart
  3. Modify the file /etc/bm/xivo.ini with the following information:

    api.key=<xuc_api_key>
    xuc.host=<xuc_host>:8090

    Note: XUC's default port is 8090 but it might be 9000 on old XUC server versions

Configuration in BlueMind

Adding the CTI server role

  • Log into BlueMind as global admin0.
  • Go to System Management > Application's servers.
  • Select the BlueMind server you want to configure as the CTI relay.
  • In the "Server roles" tab, "Telephony" section, check the box "Unified communication server":
  • Save this new configuration.

Domain Configuration

Still logged in as global admin0:

  • Go to System Management > Modify Domain.
  • Select the domain you want to set up to use Xivo.
  • In the "Telephony" tab, select the relay server:
  • Save this configuration.

Running a configuration test

You can test this configuration by simulating a XIVO event using CURL:

curl -X POST -H 'Content-Type: application/json' http://#BLUEMIND:9091/xivo/1.0/event/#DOMAIN/dropbox/ -d '{"username":"#LOGIN","status":#STATUS}'

with:

  • #BLUEMIND: BlueMind url
  • #DOMAIN : concerned domain (for example blue-mind.net)
  • #LOGIN: user login (excluding the domain)
  • #STATUS: phone status.

Supported statuses are:

  • 0: available (green)
  • 2: busy (red)
  • 8: ringing (blinking red)

Uses and integration

To know more about using and integrating telephony in BlueMind, please see user's guide pages:

  • No labels