Configuration de Xivo/Avencall

Cette page présente l'installation et la configuration des plugins BlueMind permettant une interconnexion avec le produit XiVO d'Avencall.

Configuration de Xivo

créer un utilisateur Xuc dans Services > IPBX > Users
lui activer le Xivo client et renseigner :
- login : xuc
- password : 0000
créer un Web Services user dans Configuration > Web Services Access avec les paramètres suivants :
- Login : xivows
- Password : xivows
- Host : laisser vide
S'assurer que Multiqueues call stats sharing est activé dans Services > Ipbx > Advanced configuration > Queues

Installation du plugin Xivo pour BlueMind

Prérequis

Le service XUC doit être installé côté Avencall et joignable sur le port 8090.

Créer le fichier /etc/xuc/xuc.conf :

XivoWs {
    enabled=true
}
 
api {
    eventUrl = "http://<bluemind.srv.ip:9091/xivo/1.0/event/domain.tld/dropbox/"
}
 
xucami {
    enabled = false
}

Procédure

Installer les paquets nécessaires :
- Debian/Ubuntu
- RedHat/CentOS
aptitude install bm-plugin-core-cti-xivo bm-xivobridge bm-plugin-core-cti bm-plugin-webserver-cti
yum 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
Redémarrer BlueMind après l'installation :
```
# bmctl restart
```
Créer le fichier /etc/bm/xivo.ini et indiquer les informations suivantes :
```
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

Configuration dans BlueMind

Configuration du domaine

Se connecter à BlueMind en tant qu'administrateur système ou administrateur de domaine
Se rendre sur la page Gestion du Système > Domaines supervisés
Sélectionner le domaine à paramétrer
Cliquer sur l'onglet "Téléphonie"
Sélectionner l'implémentation à utiliser, ici Xivo
Saisir l'adresse https du serveur Xivo :
Enregistrer les modifications

Configuration des utilisateurs

Se connecter à BlueMind en tant qu'administrateur système ou administrateur de domaine
Se rendre sur la page Annuaires > Entrées d'Annuaire
Sélectionner l'utilisateur ou le groupe d'utilisateurs à paramétrer
Cocher les rôles
- "Téléphonie" dans l'onglet "Accès aux applications"
- "Gérer ses comptes externes", dans l'onglet "Général"
Enregistrer les modifications

Configuration spécifique

On peut tester le bon fonctionnement en simulant un événement XIVO via CURL :

curl -X POST -H 'Content-Type: application/json' http://#BLUEMIND:9091/xivo/1.0/event/#DOMAIN/dropbox/ -d '{"username":"#LOGIN","status":#STATUS}'

avec :
- #BLUEMIND : l'url de BlueMind
- #DOMAIN : le domaine concerné (par exemple blue-mind.net)
- #LOGIN : le login de l'utilisateur (sans le domaine)
- #STATUS : le statut téléphonique
Les statuts supportés sont :
- 0 : disponible (vert)
- 2 : au téléphone (rouge)
- 8 : le téléphone sonne (rouge clignotant)

Utilisation de la téléphonie

Pour plus d'informations sur l'utilisation de la téléphonie dans BlueMind, consulter le paragraphe bm.links.UseContactDetails.

Configuration de Xivo/Avencall