Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.
Sv translation
languagefr
Remarque

Cette page n'est plus actualisée. À partir de BlueMind 4.8, veuillez consulter la nouvelle documentation BlueMind

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.

Volet
borderWidth3

Sur cette page :

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

Bloc de code
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
    titleDebian/Ubuntu
     aptitude install bm-plugin-core-cti-xivo bm-xivobridge bm-plugin-core-cti bm-plugin-webserver-cti
    Bloc de code
    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 :

    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 :

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

This page is no longer being updated. From BlueMind 4.8, please refer to the new BlueMind documentation

Introduction

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

Volet
borderWidth3

On this page:

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

Bloc de code
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
    titleDebian/Ubuntu
     aptitude install bm-plugin-core-cti-xivo bm-xivobridge bm-plugin-webserver-cti
    Bloc de code
    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:

    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:

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

Diese Seite ist nicht mehr aktuell. Ab der Version BlueMind 4.8 finden Sie alle Infos in der neuen Dokumentation

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.

Volet
borderWidth3

Auf dieser Seite:

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

Bloc de code
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
    titleDebian/Ubuntu
     aptitude install bm-plugin-core-cti-xivo bm-xivobridge bm-plugin-core-cti bm-plugin-webserver-cti
    Bloc de code
    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:

    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:

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