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.
Commentaire: Published by Scroll Versions from space DA and version BM-4.0

...

Sv translation
languageen

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

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:

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

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 est activé dans 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":

    Image Removed

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

    Image Removed

  • Speichern Sie die Konfiguration.

Funktionsprüfung

Die korrekte Funktion kann getestet werden, indem ein XIVO-Ereignis ü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: