oQueue
Produktbeschreibung
Die STARFACE Erweiterung „oQueue“ verwandelt eine normale STARFACE Ring-All-Gruppe zu einer Warteschlange mit beliebig vielen Agenten. Alle gängigen Funktionen und konfigurierbaren Parameter wie maximale Wartezeit und Teilnehmer sind enthalten. Zudem integriert die STARFACE Erweiterung ein Sprachdialogsystem (IVR).
Technische Voraussetzungen
-
ab STARFACE 8.1.0.4
-
Für dieses Modul stehen legacy Versionen ab STARFACE 7.0.0.2 zur Verfügung.
-
für KI Funktionalität: Server mit Docker, mind. 4 Core, 8GB Ram, 12GB HDD
Technische Limitierung
Dieses Modul funktioniert unabhängig von der Klingelstrategie nicht mit Callhunting.
Vorbereitung der IT-Umgebung:
Soll die KI-Funktion des Moduls genutzt werden, wird ein Server mit Docker benötigt.
Docker installieren
-
Per SSH Shell auf dem Server anmelden.
-
Docker Key Hinzufügen mit folgendem Befehl.
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
-
Docker Repository zu den APT Quellen hinzufügen.
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
-
Docker Installieren.
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
-
Installation verifizieren mit Hello-World Programm.
sudo docker run hello-world
Container Installieren
Das CoquiTTS Docker Image wird, sofern nicht vorhanden, bei der ersten Aktualisierung des Eingabetextes automatisch auf dem Server installiert und gestartet. Es ist auch möglich, den Container manuell zu installieren:
-
Mit folgendem Befehl den das Docker Image downloaden:
docker pull ghcr.io/coqui-ai/tts-cpu;
-
Folgender befehl Startet den Docker Container auf Port 5002 und mit einem Automatischen Neustart:
docker run -itd --name coquiTTS -p 5002:5002 --restart unless-stopped --entrypoint /bin/bash ghcr.io/coqui-ai/tts-cpu;
Der Name des Containers muss immer "coquiTTS" sein. |
Modulkonfiguration
Allgemein

-
Name:
-
Wähle hier den Namen der Modulinstanz. Dieser Name sollte möglichst beschreibend vergeben werden, ein guter Ausgangspunkt ist der Name des Moduls. Sollen mehrere Instanzen des selben Moduls aktiv sein, muss für jede Instanz ein einmaliger Name vergeben werden.
-
-
Beschreibung:
-
Dieses Feld bietet Raum für eine detailliertere Dokumentation der Instanz. Hier kann beispielsweise dokumentiert werden, auf welche Nutzer/Gruppen das Modul zugreift.
-
-
Logdatei:
-
Jedes Modul informiert in den Leveln "ERROR, WARN, INFO, DEBUG, TRACE" in den jeweils verschiedenen Abstufungen über Prozesse, die im Modulbetrieb ablaufen. Falls ein Fehler auftritt hat man hier die Möglichkeit, die Logdatei zu speichern. Standardeinstellung ist das Level "INFO".
-
Das Log aktualisiert sich nicht automatisch, sondern nur, wenn die entsprechende Schaltfläche betätigt wird. |
Konfiguration

STARFACE-Gruppe
Gebe die STARFACE Gruppe an, die als Warteschlange fungieren soll. Bei der Zustellung zu den Agenten greift die Klingelstrategie der gewählten Gruppe.
Queue-Regeln
-
Maximale Länge der Queue
-
Gebe hier an, wie viele Teilnehmer (Anrufer) maximal in der Warteschleife warten sollen. Mit dem Wert 0 kann die Länge auf unendlich gesetzt werden. Wird die maximale Länge überschritten, so wird die Schlussansage abgespielt (siehe Wartemusik und Ansagen) oder es greift die Umleitung bei „Besetzt“ der Gruppe.
-
-
Maximale Verweildauer
-
Gebe hier an, wie lange die Teilnehmer (Anrufer) maximal in Ihrer Warteschleife warten sollen. Mit dem Wert 0 kann die Verweildauer auf unendlich gesetzt werden. Wird die maximale Verweildauer überschritten, so wird die Schlussansage abgespielt (siehe Wartemusik und Ansagen) oder es greift die Umleitung bei Zeitüberschreitung der Gruppe.
-
-
Klingeldauer
-
Die Klingeldauer ist die Zeit, nach der ein Anrufversuch zur Gruppe abgebrochen wird und ein neuer Versuch gestartet wird. Wenn ein Agent ein Gespräch gerade beendet hat, während bereits ein neuer Anrufer klingelt, so wird sein Telefon erst nach der nächsten Klingelpause wieder mit klingeln. Priorisierte Anrufer werden in der Klingelpause an die erste Stelle gesetzt. Die Klingeldauer kann variabel zwischen 10 Sekunden und 120 Sekunden eingestellt werden. Die Zeit kann hier definiert werden.
-
-
Warten auf Agenten
-
Aktiviere diese Option, um die Anrufer in der Warteschlange zu halten, auch wenn kein Agent in der Gruppe angemeldet ist. Ist diese Option deaktiviert und kein Agent in der Gruppe angemeldet, so greift die Umleitung bei Zeitüberschreitung der Gruppe.
-
Agenten-Einstellungen
-
Nachbearbeitungszeit
-
Stelle hier eine Zeit in Sekunden ein, in der ein Agent nach einem Telefonat keine neuen Anrufe zugestellt bekommen soll, zum Beispiel zur Dokumentation des letzten Telefonats.
-
SSH Konfiguration für TTS
Soll die TTS Funktion des Moduls genutzt werden, muss hier der SSH zugang konfiguriert werden.
-
SSH-Server:
-
Definiere hier die IP-Adresse oder den DNS-Namen des SSH-Servers.
-
-
SSH-Port:
-
Gebe hier den Port an, über den die Kommunikation zum SSH-Server laufen soll (Standardwert: 22).
-
-
SSH-Benutzer/Passwort:
-
Definiere hier den Benutzer mit entsprechenden Lese- und Schreibrechten auf das gewählte Zielverzeichnis.
-
-
SSH-Zielverzeichnis:
-
Wähle hier das Zielverzeichnis aus, in dem das Modul arbeiten soll.
-
-
Fingerprint:
-
Gebe hier den Fingerprint ein, der beim ersten Modulstart im Log hinterlegt wurde.
-
Das Zielverzeichnis muss bereits existieren und es muss der absolute Pfad angegeben werden. |
Wartemusik und Ansagen

Wartemusik
Gebe hier den Namen der gewünschten Wartemusik für die Anrufer an. Die Wartemusik kann im STARFACE Admin Menü unter „Erweiterte Einstellungen“ → „Wartemusik“ konfiguriert werden. Wird keine Wartemusik konfiguriert, wird die Standard-Wartemusik (default) abgespielt.
Ansagen
-
Willkommensansage abspielen
-
Aktiviere diese Checkbox, wenn eine Willkommensansage abgespielt werden soll.
-
-
Umleitung immer greift vor der Willkommensansage
-
Mit dieser Option kann konfiguriert werden, dass die Willkommensansage nicht abgespielt wird, wenn in der Gruppe eine „Umleitung immer“ konfiguriert ist.
-
-
Willkommensansage
-
Lade hier eine Willkommensansage im .wav Format hoch.
-
-
KI-generierte Willkommensansage verwenden
-
Aktiviere diese Checkbox, wenn eine KI-generierte Willkommensansage verwendet werden soll.
-
-
Text für KI-generierte Willkommensansage
-
Gebe hier den Text ein, anhand dessen die Ansage generiert werden soll.
-
-
Schlussansagen abspielen
-
Diese Ansage wird abgespielt, wenn die maximale Länge oder die maximale Verweildauer der Warteschlange überschritten wird.
-
-
Schlussansage
-
Lade hier eine Schlussansage im .wav Format hoch.
-
-
KI-generierte Schlussansage verwenden
-
Aktiviere diese Checkbox, wenn eine KI-generierte Schlussansage verwendet werden soll.
-
-
Text für KI-generierte Schlussansage
-
Gebe hier den Text ein, anhand dessen die Ansage generiert werden soll.
-
-
Zwischenansagen
-
Die Zwischenansagen müssen als Wartemusik in der Anlage hochgeladen sein. Über das “+” können die entsprechenden Namen der Zwischenansagen angeben werden. Bei mehreren Zwischenansagen, werden die Ansagen in der Reihenfolge abgespielt, in der sie hier angelegt sind. Über die Option “Zufällige Ansage abspielen” entfällt die angelegte Reihenfolge.
-
-
Intervall
-
Geben Sie mit dem Intervall in Sekunden an, wann die Zwischenansage abgespielt und wiederholt werden soll. Der Wert für das Intervall muss mindestens 10 Sekunden sein.
-
-
KI-generierte Zwischenansage verwenden
-
Aktiviere diese Checkbox, wenn eine KI-generierte Zwischenansage verwendet werden soll.
-
-
Text für KI-generierte Zwischenansage
-
Gebe hier den Text ein, anhand dessen die Ansage generiert werden soll.
-
IVR Menü

Ansage
-
IVR aktivieren
-
Ist die Option aktiviert, werden alle Anrufe an die gewählte Gruppe unter dem Punkt „Einstellungen“ als Erstes der IVR zugestellt. Die Anrufer können anderen internen und externen Zielen, einer Mailbox oder der Warteschlange zugestellt werden.
-
-
Umleitung immer greift vor der IVR
-
Mit dieser Option kann die IVR übersprungen werden, wenn in der Gruppe eine „Umleitung immer“ konfiguriert ist.
-
-
IVR Ansage
-
Diese Ansage wird in der IVR abgespielt und gibt meistens einen Willkommensgruß sowie die verfügbaren Optionen („Drücken Sie die 1, wenn…“) wieder. Diese können als WAV-Datei hochgeladen und aktiviert werden.
-
Menükonfiguration
-
Anzahl der Ziffern
-
Mit diesem Parameter kann konfiguriert werden, aus wie vielen Ziffern die Eingabe des Anrufers bestehen soll. Hat die IVR nicht mehr als neun Optionen, so sollte den Standardwert von einer Ziffer beibehalten werden.
-
-
Maximale Wartezeit
-
Gebe mit der maximalen Wartezeit in Sekunden an, wie lange auf eine Eingabe durch den Anrufer gewartet werden soll. Verstreicht die Zeit ohne Eingabe, so wird der Anrufer zur Ausweichrufnummer weitergeleitet.
-
-
Ausweichrufnummer
-
Bei einer Fehleingabe (Eingabe einer nicht verfügbaren Option) oder beim Verstreichen der maximalen Wartezeit ohne Eingabe wird der Anrufer zur Ausweichrufnummer weitergeleitet. Diese kann hier angeben werden. Soll der Anrufer in diesem Fall der Warteschlange der Gruppe hinzugefügt werden, so lassen Sie dieses Feld leer.
-
-
Eingabezuordnung
-
Gebe tabellarisch die möglichen Eingaben und das dazugehörige Ziel an. Ziele können interne Rufnummern, externe Rufnummern und Voicemailboxen sein. Wenn es sich bei dem Weiterleitungsziel um eine Voicemailbox handelt, muss diese im Format *9[Mailboxnummer] angegeben werden. Um an die Warteschlange weiterzuleiten, lasse das Ziel leer.
-
IVR Zeitüberschreitung

Ansage
-
IVR Zeitüberschreitung aktivieren
-
Ist die Option aktiviert, werden alle Anrufe nach Ablauf der max. Verweildauer an diese IVR geleitet. Der Anrufer kann so zum Beispiel entscheiden, ob er weiter warten oder zu einer Mailbox verbunden werden möchte.
-
-
IVR Ansage
-
Diese Ansage wird in der IVR abgespielt und gibt meistens einen Willkommensgruß sowie die verfügbaren Optionen („Drücken Sie die 1, wenn…“) wieder. Diese kann als .wav Datei hochgeladen und aktiviert werden.
-
Prioritäten

Rufnummern
Gespräche können nach Anrufer- oder angerufenen Nummer priorisiert werden. Diese Anrufer werden nach einer Klingelpause vorgelassen. So können zum Beispiel VIP-Rufnummern definiert und diese mit nur einer Queue bearbeitet werden.
Die Rufnummern müssen im internationalen Format (FQTN) hinterlegt werden. Beispiel: '00492515906850'
Klingelstrategie

-
Auswahl der Klingelstrategie
-
Über dieses Feature kann die oQueue, anstatt einzelne Agenten, ganze Rufgruppen über festgelegte Klingelstrategien anrufen.
-
-
Rufgruppen
-
Die Rufgruppen werden mit Ihrer primären internen Rufnummer hinterlegt. Eine Rufgruppe wird für die hinterlegte Klingeldauer angerufen. Anschließend folgt die nächste Rufgruppe nach Vorgabe der Klingelstrategie. Die Verweildauer kann unter “Rufgruppen” für jede Gruppe einzeln definiert werden.
-
Beispiel: “10,15” lässt die Gruppe 10 für 15 Sekunden klingeln.
Bekannte Probleme
-
Bei diesem Modul liegen keine bekannten Probleme vor.
-
Problem entdeckt? Schicke eine E-Mail an support@o-byte.com, um Fehler zu melden!
Versionshinweis
-
3.0
-
Fix:
-
reimplementierung des Callhandings des Moduls im Modul-Designer um unvorhersehbares Verhalten im Callhandling der Anlage zu vermeiden.
-
-
-
3.0.1
-
Erlaube die Verwendung von Usern in der (REPEAT_)CALL_GROUPS Strategie
-
Ggf. Workaround für Buggy Redirections auf andere User
-
-
Fix:
-
Wenn die Klingeldauer zu niedrig oder zu hoch angesetzt wurde und autokorrigiert wurde wurde trotzdem der nicht korrigierte Wert verwendet.
-
-
Fix: zufälliges Abspielen von Zwischenansagen scheiterte wenn nur eine Ansage eingetragen war
-
Fix: es ist nicht mehr möglich in den IVRs die Anzahl der Ziffern auf 0 (nur Ansage abspielen) zu setzen
-
-
3.0.2
-
Fix: wenn die Länge der globalen Ortsvorwahl der PBX nicht mit der Länge der angerufenen Ortsvorwahl übereinstimmte wurden die gesetzten Rufumleitungen ausgeführt
-
Fix: wenn andere als die globalen Vorwahlen der PBX angerufen wurden wurde u.U. die Anrufernummer mit falscher (den globalen) Vorwahlen normalisiert.
-
-
3.1
-
Text-To-Speech-Funktion für Ansagen hinzugefügt
-
Tab "Einstellungen" in "Konfiguration" umbenannt
-
-
3.1.5
-
Fix:
-
Falscher Pfad für KI-generierte Zwischenansagen
-
-