Feiertagsumleitung
Dokumentation für Modulversion 2.7.5 ab STARFACE 8.1.0.4
Produktbeschreibung
Das STARFACE Modul „Feiertagsumleitung“ leitet eingehende Anrufe an Feiertagen mit optionaler Ansage auf eine interne/externe Rufnummer oder Mailbox automatisiert um. Wahlweise kann im Modul eine individuelle Ansage KI-generiert werden. In dem Modul sind bereits alle gesetzlichen Feiertage integriert und können nach Bundesland selektiert werden. Zusätzlich können weitere (örtlich spezifische) Feiertage manuell konfiguriert oder mittels Upload eine iCal-Datei (.ics) definiert werden.
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-worldModulkonfiguration
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. |
Rufnummern
Interne Gepräche
Anlageninterne Gespräche werden per Vorgabe nicht von dem Modul umgeleitet. Ist eine Umleitung der internen Gespräche gewünscht, so entferne den Haken bei dem Punkt „Interne Gespräche ignorieren“.
Angerufene Nummern
Definiere hier, für welche Zielrufnummern die Feiertagsumleitung durchgeführt werden soll. Es kann mit den STARFACE spezifischen Platzhaltern „?“ und „*“ gearbeitet werden. Trage unter „Aktiv für“ die Nummern ein, für die die Umleitung greifen soll. Definiere unter Ausnahmen Zielrufnummern, die von der Umleitung nicht berücksichtigt werden sollen. Letztgenannter Punkt wird wichtig, wenn sich zum Beispiel eine Durchwahl mit der Konfiguration für „Aktiv für“ überschneidet, insbesondere wenn mit Platzhaltern gearbeitet wurde.
Anrufernummern
Definiere hier, für welche Anrufernummern die Feiertagsumleitung durchgeführt werden soll. Es kann mit den STARFACE spezifischen Platzhaltern „?“ und „*“ gearbeitet werden. Trage unter „Aktiv für“ die Nummern ein, für die die Umleitung greifen soll. Definiere unter Ausnahmen Anrufernummern, die von der Umleitung nicht berücksichtigt werden sollen. Letztgenannter Punkt wird wichtig, wenn sich zum Beispiel eine Durchwahl mit der Konfiguration für „Aktiv für“ überschneidet, insbesondere wenn mit Platzhaltern gearbeitet wurde.
| In den meisten Fällen werden die Rufnummern in das Format 00492515906850 normalisiert. Es können in Ausnahmefällen aber auch Formate wie +492515906850 oder 02515906850 signalisiert werden. Daher empfehlen wir grundsätzlich die Verwendung von Wildcards bei der Quellrufnummer, also zum Beispiel *2515906850. |
-
Legende:
-
? - Platzhalter für eine Ziffer
-
* - Platzhalter für eine, mehrere oder keine Ziffer/n
-
Umleitung
Umleitungsziel
Unter dem Punkt Umleitungsziel wird das Ziel der Umleitung definiert, dies kann eine interne Durchwahl (zum Beispiel: 80), eine externe Nummer (zum Beispiel: 025159068580) oder eine Voicemail (zum Beispiel: *96) sein. Ein Umleitungsziel kann optional gewählt werden, ist kein Wert eingetragen, so wird lediglich die konfigurierte Ansage abgespielt und anschließend das Gespräch beendet.
Ansage
Es kann definiert werden, dass eine Ansage vor der Umleitung abgespielt werden soll. Diese kann als .wav Datei hochgeladen werden. Wird kein Umleitungsziel und keine Ansage definiert, so wird die Standardansage der STARFACE abgespielt. Werden Anrufer auf eine Voicemail umgeleitet und wurde dazu im Modul eine Ansage definiert, so ersetzt diese eine ggf. konfigurierte Ansage in der Mailbox.
| Anrufer können auf die „Außerhalb der Geschäftszeiten“-Voicemail (sofern vorhanden) umgeleitet werden und dennoch eine andere Ansage abgespielt bekommen, so ist kein Einrichten einer neuen Voicemail erforderlich. |
Text to Speech Ansage
Hier kann ein Text für eine KI-generierte Sprachansage eingegeben werden, anstatt eine Audioansage hochzuladen. Für die Einrichtung und den Betrieb des Moduls wird eine SSH verbindung zum Dienstserver benötigt. Beim ersten Start des Moduls erscheint im Log der Fingerprint, der für die Konfiguration der SSH Verbindung benötigt wird.
-
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. |
| Für die Installation des Text-to-Speech-Service wird ein Server mit Docker und mind. 12GB freiem Speicherplatz benötigt. |
| Damit dieses Feature funktioniert muss die Option "Ansage abspielen" (siehe oben) ebenfalls aktiviert sein. |
Geschäftszeiten
Hier können die Geschäftszeiten eingetragen werden. Die Umleitung wird dann am Vorabend eines Feiertages aktiviert und bleibt bis zum Arbeitsbeginn des Folgetages aktiv. Die Zeiten müssen im Format hh:mm ohne führende Nullen bei den Stunden (zum Beispiel: 8:05) angegeben werden.
Feiertage
Grundsätzlich werden alle bundeseinheitlichen Feiertage für Deutschland und Österreich (zum Beispiel: Tag der Deutschen Einheit) von dem Modul behandelt. Nicht berücksichtigt werden lokale gesetzliche Feiertage (zum Beispiel: Augsburger Hohes Friedensfest).
Diese können in der Liste „Weitere Feiertage“ manuell angegeben werden. Einträge in der Liste müssen ohne Jahreszahl angegeben werden, (zum Beispiel: 11.11). Weiterhin können Zeiträume angegeben werden (zum Beispiel: 24.12 – 31.12). Für Zeiträume über einen Jahreswechsel hinweg müssen zwei Einträge angelegt werden (zum Beispiel 24.12 – 31.12. und 1.1. – 3.1).
Samstage und Sonntage können grundsätzlich als Feiertag behandelt werden. Zudem können Heiligabend und Silvester als Feiertag behandelt werden.
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
-
2.7.5
-
Bugfix:
-
TTS-Funktion wird bei Änderungen in der Konfiguration auch dann gestartet, wenn die zugehörige Option nicht aktiviert wurde
-
-