CallBoard PRO

End of life

Dieses Modul wird - im Gegensatz zu unseren Produkten im Shop - nicht mehr proaktiv weiterentwickelt.

Überwachen Sie Ihr Call-Center und werten Sie es statistisch aus - alles aus einem übersichtlichen Web Interface.


Benutzerhandbuch

Eine ausführliche Anleitung für Agenten und Supervisoren finden Sie im Artikel CallBoard PRO Benutzerhandbuch.

Installation

Es sind zwei Betriebsarten denkbar:

1) CallBoard PRO als reines STARFACE-Modul: hier wird lediglich ein einziges STARFACE-Modul in die Anlage importiert und konfiguriert. Der CallBoard PRO-Webserver läuft anschließend auf der STARFACE-Anlage selbst auf einem anderen Port.

2) CallBoard PRO standalone: hier läuft lediglich ein schlankes STARFACE-Modul auf der Anlage selbst und stellt lediglich die Datenschnittstelle zur STARFACE bereit. Der eigentliche CallBoard PRO Webserver läuft auf einer eigenständigen virtuellen Maschine ("VM") auf einem separatem Server und verbindet sich anschließend mit dem dazugehörigen STARFACE-Modul. Diese Variante empfiehlt sich insbesondere für STARFACE Appliances (PRO bis ADVANCED) sowie generelle STARFACE-Anlagen mit mehr als 5 iQueues bzw. 10 Agenten.

CallBoard PRO (Variante 1: als reines STARFACE-Modul)

Beachten Sie für die Installation unsere Anleitung zur Installation von Modulen.

Beachten Sie, dass das CallBoard PRO keine Autostart-Funktion kennt. Es muss daher bei Neustart der STARFACE (oder auch der STARFACE-Dienste) manuell einmal neu gestartet werden, indem die Modulkonfiguration deaktiviert und nach ein paar Sekunden wieder aktiviert wird. Idealerweise schalten Sie das CallBoard PRO vor solchen Neustarts aus und erst danach wieder ein.

Vor STARFACE-Updates und Änderungen an STARFACE-Gruppen empfehlen wir dringend, das CallBoard PRO auszuschalten, um Fehlfunktionen während des Updates zu vermeiden. Konsultieren Sie auch unser Support-Team, um Kompatibilitäten mit neueren STARFACE-Versionen vor dem Update zu klären.

Diese Betriebsart ist nicht für die STARFACE Cloud verfügbar. Hier muss die Variante 2 (CallBoard PRO als VM) gewählt werden.

Aufgrund eines Bugs in den STARFACE-Versionen ab 6.0 muss, nachdem der Name einer iQueue geändert wurde, ein Dienste-Neustart durchgeführt werden.

CallBoard PRO (Variante 2: als VM)

  1. Installieren und konfigurieren Sie zunächst ganz klassisch das STARFACE-Modul des CallBoard PROs (Download siehe unten).
  2. Installieren Sie anschließend die CallBoard PRO standalone VM (Download siehe unten).
  3. Konfigurieren Sie die VM, um diese mit dem STARFACE-Modul zu verbinden.
  4. Starten Sie die VM anschließend neu.

Anforderungen an die VM

Folgende Minimalkonfiguration werden für die virtuelle Maschine empfohlen:

Hypervisor: VirtualBox (Manuelle Installation für andere Hypervisor/Betriebssysteme nach Aufwand) 

CPU (Prozessor): 2 Kerne

HDD (Festplatte): 20 GB

RAM (Arbeitsspeicher): 8 GB

Bitte beachten Sie, dass die Anforderungen immer individuell von vielen Parametern abhängt (STARFACE-User, Anrufaufkommen, Anzahl iQueues, Anzahl parallele CallBoard-Agenten mit geöffnetem Browser) und ggf. höher sein müssen. 

Konfiguration

Damit das CallBoard PRO funktionieren kann, darf nur eine Modulkonfiguration erstellt werden.

Einstellungen

  • Der Name der Modulkonfiguration muss zwingend "Callboard" sein (case sesitive!).
  • Login-ID und Passwort von einem STARFACE-Admin sind erforderlich, damit das CallBoard die Daten ordnungsgemäß von allen Warteschlangen erhalten kann.
  • Es können beliebig viele Warteschlangen eingetragen werden. Diese werden dann überwacht. Beachten Sie: Es müssen die Gruppennamen der zu verwendenden iQueues dem Callboard bekannt gemacht werden. Es werden ausschließlich die in der Modulkonfiguration angegebenen Gruppen im Callboard angezeigt. Bitte auf exakt identische Schreibweise des Gruppennamens achten.
  • Um den Überblick zu behalten, können Sie Tagesbeginn und -ende in Stunden angeben. Die Tagesstatistik wird darüber hinaus nichts anzeigen.
  • Aktivieren Sie in jeder zu überwachenden STARFACE-Gruppe im Reiter "Auswertung" die Live- und Historyschnittstelle. Wählen Sie unbedingt die dazugehörige Benutzergruppe aus.

Lizenz

Tragen Sie hier die Lizenz ein, die Sie bei uns erworben haben.

Die Lizenz ist für eine bestimmte Anzahl Agenten ausgestellt. Diese Agenten können aber in beliebig vielen Warteschlangen aktiv sein. Wenn Sie bspw. zwei Warteschlangen haben mit je fünf Agenten, von denen sich aber zwei überschneiden, dann haben Sie acht Agenten in der Lizenzzählung (die beiden Agenten, die in beiden Warteschlangen aktiv sind, werden nur ein Mal gezählt).

Somit handelt es sich um eine Lizenzierung nach "named user" (und nicht "concurrent user").

Verwendung

Rufen Sie die Adresse des CallBoard PRO auf: http://<IP der STARFACE>:8081.

Funktionen

Ein Embedded Browser (Google Chrome), der sich ohne Adminrechte installieren lässt und die CallBoard-Anzeige browserunabhängig erlaubt. 

Konfiguration der STARFACE-IP-Addresse

  1. Unter Windows den Datei-ausführen-Dialog mit WINDOWS-R öffnen.
  2. Folgendes eingeben: notepad %USERPROFILE%\AppData\Roaming\o-byte.com\CallBoard PRO 2 Client\RunCallBoardPRO2.cmd
  3. In der ersten Zeile das http://<STARFACE-IP>:8081 durch ihre STARFACE-Addresse ersetzen (z.B. http://192.168.1.2:8081). Der Port ist immer 8081 und das Protokoll ist immer http.


Es muss eine STARFACE-Gruppe mit der Klingelstrategie "iQueue". Andere Warteschlangen-Module mit ähnlicher Funktion werden nicht vom CallBoard PRO unterstützt.

Herunterfahren

Deaktivieren Sie immer vor einem STARFACE Neustart händisch die Modulkonfiguration des CallBoard's, damit z.B. ein Backup erstellt wird.

Downloads

CallBoard PRO 4

Bekannte Einschränkungen

Folgende CallBoard PRO 3 Funktionalitäten stehen erst wieder in zukünftigen CallBoard PRO 4 Versionen zur Verfügung:

  • Mehrsprachigkeit
  • Live-Matrix: Ein- und Ausbuchen von Agenten per Mausklick (gelöst mit Modulversion 34)
  • Live-Matrix: Definition von Backup-Agenten (gelöst mit Modulversion 48)


DatumModulversionGetestet mit Starface VersionDownloadChangelog
26.02.20207 6.7.1.14

Hinweis: ein evtl. bereit vorhandenes CallBoard PRO 3 Modul muss zuvor deinstalliert und somit eine neue Modulkonfiguration angelegt werden!

  • Basiert auf CallBoard PRO 3 (Modulversion 479.2)


  • Neue Features:
    • App Agentenstatistik: neue Spalten bzgl. der "Statusdauer":
      • Verfügbar Zeit
      • Nacharbeit Zeit
      • Pause Zeit
      • Abwesend Zeit
  • Bugfixes:
    • Verbesserte Performance bei der Nachberechnung alter Statistiken
30.03.202096.6.0.*, 6.7.0.*, 6.7.1.*

Für STARFACE 6.6.0.* und 6.7.0.*:

CallBoard_PRO_4_v9 (until 6.7.0._).sfm [BETA!]


Für STARFACE 6.7.1.*:

CallBoard_PRO_4_v9 (from 6.7.1._).sfm

  • Neue Features:
    • In der App "Historische Statistik" werden drei neue Spalten angezeigt:
      • Min. eingeloggte Agenten
      • Max. eingeloggte Agenten
      • Avg. eingeloggte Agenten (Durchschnitt)
  • Bugfixes:
    • Lizenzdatei wird bei Ersteinrichtung korrekt verarbeitet
09.04.2020106.6.0.*, 6.7.0.*, 6.7.1.*

Für STARFACE 6.6.0.* und 6.7.0.*:

CallBoard_PRO_4_v10 (until 6.7.0._).sfm [BETA!]


Für STARFACE 6.7.1.*:

CallBoard_PRO_4_v10 (from 6.7.1._).sfm

  • Bugfixes:
    • Historische Statistik: Anzahl Agenten wird auch in neuen Intervallen bei keiner Veränderung der eingeloggten Agenten korrekt angezeigt
05.06.2020206.6.* - 6.7.1.*

Für STARFACE 6.6.* und 6.7.0.*:
CallBoard_PRO_4_v20 (bis 6.7.0).sfm [BETA!]

Ab STARFACE 6.7.1.*:
CallBoard_PRO_4_v20 (ab 6.7.1).sfm 

  • Bugfixes:
    • Behebt Fehler nach manuellem Reset und Neuberechnung der Statistiken
    • Lizenzmechanismus
07.07.2020326.7.1.*
  • Bugfixes:
    • Behebt automatisches Einloggen anderer Agenten, sobald sich ein Agent ausloggt.
16.07.2020

33

6.7.1.*
  • Security Fix: AD-Passwörter
30.09.2020346.7.1 - 6.7.3
  • Features:

    • Agenstatus per Mausklick in Live-Matrix setzen

  • Verbesserungen:
    • Agenten müssen nicht mehr einmalig im CallBoard PRO eingeloggt sein, um diese in den CallBoard PRO Apps ausl Supervisor auswählen zu können.
  • Bugfixes:

    • Vermeidung von STARFACE Fehlermeldungen z.B. beim Erstellen Gruppen (bzgl. Meldung  "cb2account2parent_audit")

03.11.2020486.7.1 - 6.7.3
  • Features:
    • App "Live-Matrix": Automatisches Hinzufügen von Backup-Agenten bei Überschreitung eines einstellbaren Schwellenwertes
  •  Bugfixes:
    • Stabilitätsverbesserung beim An- und Abmelden von Agenten über die App "Live-Matrix"
12.11.2020496.7.1 - 6.7.3
  • Verbesserungen:
    • App "Historische Statistik" / Feature "Excel-Export": Numerische Werte werden nun als "Zahl" formatiert, um Berechnungen in Excel durchführen zu können.
16.12.2020526.7.1 - 6.7.3CallBoard_PRO_4_v52.sfm

Features:

  • App "Historische Statistik": Neue Spalte "Gewichteter Durchschn. eingeloggter Agenten" (Berechnung immer auf Basis der 15-Minuten-Datenpunkte)

Verbesserungen:

  • App "Historische Statistik": Spaltenüberschriften in Excel-Export ohne Zeilenumbrüche

Bugfixes:

  • Fehler beim An-/Abmelden von Agenten via Agenten-App behoben.
26.01.2021536.7.1 - 6.7.3CallBoard_PRO_4_v53.sfm
  • Fix: STARFACE Backups schlagen nicht mehr fehl
05.02.2021546.7.1 - 6.7.3.11 (nicht >= 6.7.3.20)
  • Fix: STARFACE Datenbankgröße nimmt nicht mehr unverhältnismäßig zu
12.02.2021556.7.3.20
  • Fix: Login wieder möglich mit STARFACE 6.7.3.20

Bekannte Einschränkungen:

  • Die CallBoard PRO App "Historische Statistik" liefert unter bestimmten Umständen nur noch 0-Werte für Queue-Kennzahlen. Hier hilft ein Skript (siehe FAQ weiter unten)   

CallBoard PRO 1 bis 3

STARFACE-Modul

DatumModulversionGetestet mit Starface VersionDownloadChangelogInstallationshinweise
11.12.2017456 6.4.3.(26-28)


17.01.2017457 6.4.3.(26-28)
  • Hilfe-Tab aktualisiert

24.01.2018458 6.4.3.(26-28)
  • Hilfe-Tab: Entfernter Text "Vielen Dank..."

27.04.20184706.4.3.(26-28)
  • Offline-Lizenzmechanismus

26.06.20184726.5.0.30CallBoard_PRO_v472.sfm
  • Kompatibilität mit STARFACE 6.5.

28.08.20184756.5.1.5

15.08.20184746.4.3.(26-34)CallBoard_PRO_v474.sfm
  • Implement export agent statistic csv file (to SMB)
(Extended version 470

22.11.20184776.5.1.*CallBoard_PRO_v477.sfm
  • Kompatibilität

30.11.20184786.5.1.9 - 6.6.0.*
  • Bugfix: Wiederherstellung der der AD-Auth-Funktion

14.08.20194796.5.1.* - 6.6.*, 6.7.0.*CallBoard_PRO_v479.sfm
  • Bugfix: Verhindert Abschaltung der Modulkonfiguration bei internem DB-Fehler

25.02.2020479.2 (angezeigt als 479)6.5.1.* - 6.6.*, 6.7.0.*CallBoard_PRO_v479_lic_v3.sfm
  • Bugfix: Anzahl der CallBoard PRO Agenten (named STARFACE User in iQueues) wird wieder korrekt vom Lizenzmechanismus ausgelesen
  • Vorhandene Modulkonfiguration deaktivieren
  • Neue .sfm-Datei in die Modul-Library hochladen (bestehende Modulkonfiguration kann erhalten bleiben)
  • Vorhandene Modulkonfiguration aktivieren


Standalone VM

Datum
CBP-Standalone Version
Enthält CallBoard Modul-Version...
Download (extern)
Changelog
12.2.20183.12.3-sa-1v458http://download.o-33.de/cbp-3-12-3-sa-1.ova
10.7.20183.13v472http://download.o-33.de/cbp-3.13.ova
  • Enthält neuer CallBoard PRO Version 472
31.1.20194.0v478cbp-478-installer-debian9.zip
  • Verbesserung: Bereitstellung eines Installers bzw. Updaters (statt eines VM-Images/einer OVA-Datei). Setzt ein bereits installiertes Debian 9 Linux-Betriebssystem voraus. Zur Installation den heruntergeladenen Installer auf der VM auspacken und die install.sh aufrufen.
23.3.20214.1CBP4-v55http://download.o-33.de/cbp4-55-installer-1.0.4-debian9.zip
  • Aktualisierung: enthält CallBoard PRO 4, Modulversion 55

Zur Fehleranalyse senden Sie uns bei Bedarf bitte die Logdateien in folgenden Verzeichnissen:

  • /var/starface/module/modules/repo/callboard/logs
  • /var/log/callboard

Loggen Sie sich dazu bitte per SSH auf der STARFACE ein und laden Sie die Verzeichnisse mit Hilfe von z.B. WinSCP herunter.

CallBoard PRO löschen/zurücksetzen

Achtung: diese Maßnahme löscht unwiderruflich alle benutzerspezifischen Einstellungen für z.B. Bildschirmpositionen, App-Konfigurationen und Export-Jobs auf Netzlaufwerke. Diese Einstellungen sind auch nicht durch Wiederherstellung eines STARFACE Backups zurückzuholen.

  1. Modulkonfiguration löschen (nur so wird das lokale Backup database_backup.sql innerhalb der Modulkonfiguration gelöscht).
  2. Per SSH einloggen, dieses Script herunterladen und ausführen.
  3. Modulkonfiguration neu erstellen.
  4. Mindestens 15 Minuten mit dem CallBoard PRO-Login warten, da alle Statistiken vom CallBoard rückwirkend neuberechnet werden.

FAQ

Frage/ProblemAntwort/Lösung
Wo finde ich die detaillierte Logs zum CallBoard PRO auf der STARFACE?

Per STARFACE Webinterface:

  • Administration → Module → Modulkonfiguration "CallBoard PRO" → Logfenster (Log-Level "TRACE" empfohlen)


Per SSH:

  • /var/log/callboard/callboard.log
  • /var/log/callboard/trace.log
  • /var/starface/module/modules/repo/callboard/logs/catalina.out
Im Modul-Log steht ein ERROR von der Datenbank.Das macht nichts. Dieser "Fehler" ist gar keiner, sondern wird nur so angezeigt, weil das Datenbank-Framework die Rückgabe falsch interpretiert. Es ist alles in Ordnung.
Es kann keine Verbindung aufgebaut werden.Deaktivieren Sie Ihre Modulkonfiguration. Prüfen Sie, dass wirklich nur eine davon existiert. Warten Sie kurz und aktivieren Sie die Modulkonfiguration wieder. Nach etwa einer Minute sollte das CallBoard PRO fertig geladen sein. Wenn Sie weiterhin gar nichts sehen, starten Sie bitte in einem ruhigen Moment die STARFACE neu.
Das CallBoard PRO öffnet sich, zeigt aber keine Daten.
  • Deaktivieren Sie Ihre Modulkonfiguration. Prüfen Sie, dass wirklich nur eine davon existiert. Warten Sie kurz und aktivieren Sie die Modulkonfiguration wieder. Nach etwa einer Minute sollte das CallBoard PRO fertig geladen sein. 
  • Prüfen Sie, ob in den zu überwachenden Warteschlangen (STARFACE-Gruppen) die History- und Live-Schnittstelle aktiviert worden sind. Weiterhin muss die dazugehörige Benutzergruppe eingetragen werden.
  • Stellen Sie sicher, dass die STARFACE niemals neugestartet wird, bevor nicht die Modulkonfiguration"Callboard" händisch deaktiviert wurde (z.B. durch automatische nächtliche Neustarts).
  • Wenn Sie weiterhin gar nichts sehen, deaktivieren Sie die Modulkonfiguration "Callboard" und starten Sie bitte in einem ruhigen Moment die STARFACE neu.
Das CallBoard PRO startet nicht mehr / im Browser wird keine Login-Eingabemöglichkeit gezeigt.
  • Prüfen Sie, ob auf der Festplatte noch genug Speicherplatz ist.
Nach Login im Webinterface wird "Ein unerwarteter Fehler ist aufgetreten." angezeigt.
  • Deaktivieren Sie die Modulkonfiguration.
  • Loggen Sie sich per SSH auf der STARFACE ein und führen Sie das Kommando "deleteTables.sh" aus.
  • Aktivieren Sie die Modulkonfiguration.
Ein neu angelegter STARFACE User kann in der "Agenten"-App nicht ausgewählt werden, weil er dort nicht gelistet ist.
  • Stellen Sie sicher, dass der fehlende Agent sich mindestens einmal im CallBoard PRO selbst mit seinen eigenen Zugangsdaten eingeloggt hat.
  • Laden Sie danach die CallBoard PRO Website im Browser neu.
Beim Login erscheint die Fehlermeldung "Ein Login mit diesen Zugangsdaten ist nicht möglich" [Standalone/VM Variante]
  • Bitte nutzen Sie die Option "newauth: true" in der /etc/callboardpro.conf. Starten Sie den Dienst "callboard" anschließend neu.
  • Prüfen Sie, ob die CallBoard PRO Lizenz die entsprechende Anzahl an iQueue-Gruppenmitgliedern erlaubt.
Was hilft bei unlösbaren Problemen?

Diese Methode setzt alle gerätespezifische Benutzereinstellungen (geöffnete Apps, Fensterpositionen) unwiderruflich zurück. Statistiken sind davon jedoch nicht betroffen.


  • Loggen Sie sich via ssh auf die STARFACE und öffnen Sie die psql-Konsole:
    • ssh root@<STARFACE-IP>
      psql asterisk
  • Leeren Sie die Tabellen 'cb2userdevice', 'cb2user', 'cb2appinstance' und 'cb2appuserdeviceconfig'
    • truncate cb2userdevice;
      truncate cb2user;
      truncate cb2appinstance;
      truncate cb2appuserdeviceconfig;

      :

Wie kann ich die CallBoard PRO Datenbank löschen?
  1. Via SSH mit Datenbank verbinden:
ssh root@<STARFACE-IP>
psql asterisk

2. CallBoard PRO Tabellen löschen:

drop table cb2account2parent_audit;
drop table cb2account2parent_audit_id_seq;
drop table cb2agentbackupsettingsentry;
drop table cb2agentdeliberatestateentry;
drop table cb2agenthistoryentry;
drop table cb2appinstance;
drop table cb2appuserdeviceconfig;
drop table cb2queuebackupsettingsentry;
drop table cb2queuehistoryentry;
drop table cb2user;
drop table cb2userdevice;	

3. CallBoard PRO Modulkonfiguration löschen und ggf. neuinstallieren

Die CallBoard PRO App "Historische Statistik" zeigt nur noch "0" Werte an.

Hier hilft die Ausführung dieses Skripts per SSH: 

callboard-recalculate-cb2queuehistoryentry-and-restart.sh

Das Skript setzt die zwischenberechneten Queue-Statistiken zurück und startet den CallBoard PRO Dienst neu. So wird eine Neuberechnung ab 1.1.2022 ausgelöst.

Achtung: je nach Agenten-, iQueue- und Anrufvolumen kann dies eine Weile dauern.


Kennst Du schon den Nachfolger der Modul-Manufaktur? www.sync.blue