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

1. Installer les paquets nécessaires :

   Bloc de code
   title Debian/Ubuntu
   aptitude install bm-plugin-core-cti-xivo bm-xivobridge bm-plugin-core-cti bm-plugin-webserver-cti

   Bloc de code
   title RedHat/CentOS
   yum install bm-plugin-core-cti-xivo bm-xivobridge bm-plugin-core-cti bm-plugin-webserver-cti

   Info
   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

2. Redémarrer BlueMind après l'installation :

   Bloc de code
   # bmctl restart

3. Créer le fichier /etc/bm/xivo.ini et indiquer les informations suivantes :

   Bloc de code
   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

Toujours connecté en tant qu'administrateur global admin0 :

• Aller dans Gestion du système > Domaines supervisés
• Sélectionner le domaine à configurer pour utiliser Xivo
• Dans l'onglet «Téléphonie», modifier le serveur Xivo :
  

  

• Enregistrer la configuration.

Test de fonctionnement

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 : url BlueMind
• #DOMAIN : le domaine concerné (par exemple blue-mind.net)
• #LOGIN : 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 et intégration

Pour en savoir plus sur l'utilisation et l'intégration de la téléphonie au sein de BlueMind, consultez les pages dédiées du guide de l'utilisateur :

• La téléphonie
• La messagerie instantanée

Configuring Xivo

• create a Xuc user in Services -> IPBX -> Users
• enable the Xivo client for this user using the following:
  • 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

Prerequisite

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

/etc/xuc/xuc.conf contents:

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:

   Bloc de code
   title Debian/Ubuntu
   aptitude install bm-plugin-core-cti-xivo bm-xivobridge bm-plugin-webserver-cti

   Bloc de code
   title RedHat/CentOS
   yum install bm-plugin-core-cti-xivo bm-xivobridge bm-plugin-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.

2. Once they are installed, restart BlueMind:

   Bloc de code
   # bmctl restart

3. Modify the file /etc/bm/xivo.ini with the following information:

   Bloc de code
   api.key=<xuc_api_key> xuc.host=<xuc_host>:8090

   Note: XUC's default port is 8090 but it might be 9000 on old XUC server versions
   

Configuration in BlueMind

Domain Configuration

Still logged in as global admin0:

• Go to System Management > Modify Domain.
• Select the domain you want to set up to use Xivo.
• In the "Telephony" tab, enter the relay server:
  
• Save this configuration.

Running a configuration test

You can test this configuration by simulating a XIVO event using 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: BlueMind url
• #DOMAIN : concerned domain (for example blue-mind.net)
• #LOGIN: user login (excluding the domain)
• #STATUS: phone status.

Supported statuses are:

• 0: available (green)
• 2: busy (red)
• 8: ringing (blinking red)

Uses and integration

To know more about using and integrating telephony in BlueMind, please see user's guide pages:

• Telephony
• Instant Messaging

Xivo konfigurieren

• einen Xuc-Benutzer unter Dienste -> IPBX -> Users anlegen
• Für den Benutzer den Xivo-Client aktivieren und ihn informieren:
  • Login: xuc
  • Passwort: 0000

• Legen Sie unter Konfiguration > Web Services Access einen Web Services-Benutzer mit den folgenden Einstellungen an:

  • Login: xivows
  • Passwort: xivows
  • Host: leer
• Stellen Sie sicher, dass Multiqueues call stats sharing in Services > Ipbx > Advanced configuration > Queues aktiviert ist

Installieren des Xivo-Plugins für BlueMind

Voraussetzung

Der XUC-Dienst muss auf der Avencall-Seite installiert und auf Port 8090 erreichbar sein.

Erstellen Sie die Datei /etc/xuc/xuc.conf :

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

Verfahren

1. Installieren Sie die notwendigen Pakete:

   Bloc de code
   title Debian/Ubuntu
   aptitude install bm-plugin-core-cti-xivo bm-xivobridge bm-plugin-core-cti bm-plugin-webserver-cti

   Bloc de code
   title RedHat/CentOS
   yum install bm-plugin-core-cti-xivo bm-xivobridge bm-plugin-core-cti bm-plugin-webserver-cti

   Info
   Bei einer verteilten Installation auf mehreren Servern muss das Paket bm-plugin-webserver-cti auf dem Server installiert werden, der den Dienst bm-webserver hostet

2. Starten Sie BlueMind nach der Installation neu:

   Bloc de code
   # bmctl restart

3. Erstellen Sie die Datei /etc/bm/xivo.ini und geben Sie die folgenden Informationen an:

   Bloc de code
   xuc.host=<xuc_host>:8090

   Hinweis: Der Standard-XUC-Port ist 8090, aber ältere Versionen des XUC-Servers hören möglicherweise auf Port 9000
   

Konfiguration in BlueMind

CTI-Server-Rolle hinzugefügt

• Anmeldung bei BlueMind als globaler Administrator admin0
• Gehen Sie zu Systemadministration > Application Servers
• Wählen Sie den BlueMind-Server aus, der als CTI-Relay konfiguriert werden soll.
• Aktivieren Sie auf der Registerkarte "Server-Rollen" unter "Telefonie" das Kontrollkästchen "Einheitlicher Kommunikationsserver":
  

  

• Speichern Sie die neue Konfiguration.

Domain-Konfiguration

Weiterhin als globaler Administrator admin0 eingeloggt:

• Gehen Sie zu Systemadministration > Überwachte Domains
• Wählen Sie die für die Verwendung von Xivo zu konfigurierende Domain
• Wählen Sie in der Registerkarte "Telefonie" den Relay-Server aus:
  

  

• Speichern Sie die Konfiguration.

Funktionsprüfung

Die korrekte Funktion kann getestet werden, indem ein XIVO-Termin über CURL simuliert wird:

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

mit:

• #BLUEMIND: url BlueMind
• #DOMAIN: die betreffende Domain (z. B. blue-mind.net)
• #LOGIN: Benutzeranmeldung (ohne Domain)
• #STATUS: Telefonstatus

Die unterstützten Zustände sind:

• 0: verfügbar (grün)
• 2: am Telefon (rot)
• 8: das Telefon klingelt (blinkt rot)

Verwendung und Integration

Weitere Informationen über die Nutzung und Integration von Telefonie in BlueMind erhalten Sie in den entsprechenden Seiten des Benutzerhandbuchs:

• Telefonie
• Instant Messaging