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

    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 it works properly 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: the phone status
Supported statuses are:
- 0: available (green)
- 2: on the phone (red)
- 8: the phone is ringing (flashing red)

Use of the telephone​

For further information on using the phone feature in BlueMind, see the section Viewing and Using a Contact Card.

Find out more​

Related BlueMind documentation pages