Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DA and version BM-4.0
Sv translation
languagefr

Présentation

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

Panel
borderWidth3

Sur cette page :

Table of Contents
maxLevel2

En rapport :

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 :

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

    Code Block
    titleDebian/Ubuntu
     aptitude install bm-plugin-core-cti-xivo bm-xivobridge bm-plugin-core-cti bm-plugin-webserver-cti
    Code Block
    titleRedHat/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 :

    Code Block
    # bmctl restart
  3. Créer le fichier /etc/bm/xivo.ini et indiquer les informations suivantes :

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

Ajout du rôle de serveur CTI

  • Se connecter à BlueMind en tant qu'administrateur global admin0
  • Aller dans Gestion du système > Serveurs de l'application
  • Sélectionner le serveur BlueMind à configurer pour être le relais CTI.
  • Dans l'onglet «Rôles du serveur»,  rubrique «Téléphonie», cocher la case "Serveur de communication unifiée" :

  • Enregistrer la nouvelle configuration.

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», sélectionner le serveur relais :

  • Enregistrer la configuration.

Test de fonctionnement

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

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

Sv translation
languageen

Introduction

This document shows how to install and configure the BlueMind plugins that allow interconnexion with Avencall's XiVO.

Panel
borderWidth3

On this page:

Table of Contents
maxLevel2

Related:

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:

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

    Code Block
    titleDebian/Ubuntu
     aptitude install bm-plugin-core-cti-xivo bm-xivobridge bm-plugin-webserver-cti
    Code Block
    titleRedHat/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:

    Code Block
    # bmctl restart
  3. Modify the file /etc/bm/xivo.ini with the following information:

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

Adding the CTI server role

  • Log into BlueMind as global admin0.
  • Go to System Management > Application's servers.
  • Select the BlueMind server you want to configure as the CTI relay.
  • In the "Server roles" tab, "Telephony" section, check the box "Unified communication server":
  • Save this new configuration.

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, select the relay server:
  • Save this configuration.

Running a configuration test

You can test this configuration by simulating a XIVO event using CURL:

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

Sv translation
languagede

Präsentation

In diesem Dokument werden die Installation und Konfiguration der BlueMind-Plugins erläutert, die eine Verbindung mit dem XiVO-Produkt von Avencall ermöglichen.

Panel
borderWidth3

Auf dieser Seite:

Table of Contents
maxLevel2

Verwandt:

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 :

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

    Code Block
    titleDebian/Ubuntu
     aptitude install bm-plugin-core-cti-xivo bm-xivobridge bm-plugin-core-cti bm-plugin-webserver-cti
    Code Block
    titleRedHat/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:

    Code Block
    # bmctl restart
  3. Erstellen Sie die Datei /etc/bm/xivo.ini und geben Sie die folgenden Informationen an:

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

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