Skip to main content
Version: 5.7

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 with 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

    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. Restart BlueMind after installation:

    # bmctl restart

  3. 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​

  • Log on to BlueMind as system administrator or domain administrator
  • Go to the page System Management > Manage Domains
  • Select the domain you want ton configure
  • Click the "Telephony" tab
  • Select the implementation to use here XiVO
  • Enter the server's HTTPS address: XiVO:
  • Save the changes

User configuration​

  • Log on to BlueMind as system administrator or domain administrator
  • Go to the page Directories > Directory Browser
  • Select the user or user group you want to configure
  • Check the roles
    • "Telephony" in the "App Access" tab
    • "Manage External Accounts" in the "General" tab
  • Save the changes

Specific configuration​

You can test that everything is working correctly by simulating a 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: the user’s login (without the domain)
  • #STATUS: telephone status

The supported statuses are:

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

Use of the telephone​

For further information on using the phone feature in BlueMind, see the section at Viewing and using a contact record.

Find out more​

Related BlueMind documentation pages