Skip to main content
Version: 4.9

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
  • activate the customer Xivo and enter :
    • 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​

Prerequisites​

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

Create a file /etc/xuc/xuc.conf:

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-add-on-core-cti-xivo bm-xivobridge bm-add-on-core-cti bm-add-on-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. Restart BlueMind after installation:
# 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

BlueMind configuration​

Domain configuration​

Always logged in as global administrator admin0 :

  • Go to System Management > Manage Domains
  • Select the domain to be configured to use Xivo
  • In the "Telephony" tab, edit Xivo server:
  • Save configuration.

Function test​

You can test this by simulating an XIVO event via 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 : url BlueMind
  • #DOMAIN: the relevant domain (e.g. blue-mind.net)
  • #LOGIN: user login (without domain)
  • #STATUS: telephone status

The supported statuses are :

  • 0: available (green)
  • 2: on the phone (red)
  • 8: Phone rings (flashing red)