Skip to main content

Setting Up Xivo/Avencall

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

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:
aptitude install bm-plugin-core-cti-xivo bm-xivobridge bm-plugin-core-cti bm-plugin-webserver-cti
info

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

  1. Once they are installed, restart BlueMind:
# bmctl restart
  1. Modify the file /etc/bm/xivo.ini with the following information:
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

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, enter 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)