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
  • 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: leave empty
  • Make sure 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-plugin-core-cti-xivo bm-xivobridge bm-plugin-core-cti bm-plugin-webserver-cti
> Dans le cas d'une installation répartie sur plusieurs serveurs, le paquet `bm-plugin-webserver-cti` devra être installé sur le serveur hébergeant le service `bm-webserver`
  1. Restart BlueMind after installation :
```
# bmctl restart
```
  1. Modify the file /etc/bm/xivo.ini with the following information:
```
xuc.host=<xuc_host>:8090
```  

> *NB : Le port par défaut de XUC est le 8090, mais il se peut que d'anciennes versions du serveur XUC écoutent sur le port 9000*

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, modify the 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: the BlueMind url
  • #DOMAIN: the relevant domain (e.g. blue-mind.net)
  • #LOGIN: user login (without domain)
  • #STATUS: phone status

The supported statuses are :

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