Ansage aufnehmen

Ansage aufnehmen

Dokumentation für Modulversion 2.5.3 ab STARFACE 8.1.0.4

Produktbeschreibung

Mit dem Modul "Ansage aufnehmen" für STARFACE können durch einen simplen Anruf neue Ansagen für Mailboxen aufgenommen und Konfiguriert werden. Anrufen, Ansage aufnehmen, und fertig!

Anwendungsbeispiel

Sollen Nutzer ohne Administrationsrechte auf der STARFACE Ansagen für andere Module aufnehmen, liefert dieses Modul die Lösung. Ansagen für eine Zeitgesteuerte Umleitung können so beispielsweise direkt vom Telefon aus aufgenommen werden und sind dann sofort verfügbar.

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

Vorbereitung der IT-Umgebung:

Soll die KI-Funktion des Moduls genutzt werden, wird ein Server mit Docker benötigt.

Docker installieren

Melde dich per SSH auf dem Debian-Server an und füge zunächst den Docker-Schlüssel hinzu:

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

Füge anschließend das Docker-Repository zu den APT-Quellen hinzu:

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

Installiere Docker:

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Prüfe die Installation mit dem Hello-World-Container:

sudo docker run hello-world

Container Installieren

Das CoquiTTS-Docker-Image wird bei der ersten Aktualisierung des Eingabetextes automatisch auf dem Server installiert und gestartet, sofern es noch nicht vorhanden ist.

Alternativ kannst du das Image manuell herunterladen:

docker pull ghcr.io/coqui-ai/tts-cpu

Starte den Container auf Port 5002 und aktiviere den automatischen Neustart:

docker run -itd --name coquiTTS -p 5002:5002 --restart unless-stopped --entrypoint /bin/bash ghcr.io/coqui-ai/tts-cpu

Wichtig: Der Containername muss coquiTTS lauten.

STARFACE-Konfiguration

  • Es muss vorab keine Konfiguration in der STARFACE vorgenommen werden.

Modulkonfiguration

Allgemein

Konfiguration Allgemein

  • Name

    • Wähle einen möglichst beschreibenden Namen für die Modulinstanz. Sollen mehrere Instanzen desselben Moduls aktiv sein, muss jede Instanz einen eindeutigen Namen besitzen.

  • Beschreibung

    • Dieses Feld bietet Raum für eine genauere Dokumentation der Instanz. Hier kann beispielsweise festgehalten werden, auf welche Benutzer oder Gruppen das Modul zugreift.

  • Logdatei
    • Die Log-Level ERROR, WARN, INFO, DEBUG und TRACE liefern unterschiedlich detaillierte Informationen über die Abläufe im Modulbetrieb. Bei einem Fehler kann die Logdatei zur weiteren Analyse gespeichert werden. Die Standardeinstellung ist INFO.

Hinweis

Das Log aktualisiert sich nicht automatisch. Betätige die entsprechende Schaltfläche, um die Anzeige zu aktualisieren.

Rufnummern

rufnummern

Definiere hier, welche Rufnummer(n) für die Aufnahme der Ansage gewählt werden können.

Konfiguration

konfiguration

Ansagetyp

Definiere hier, für welche Umleitungsart die aufgenommene Ansage konfiguriert werden soll. Es können mehrere Modulinstanzen mit unterschiedlichen Rufnummern definiert werden, um unterschiedliche Szenarien abzudecken.

  • BUSY: Die aufgenommene Ansage wird so konfiguriert, dass diese abgespielt wird, sobald eine Umleitung bei „Besetzt“ auf die Voicemail erfolgt.

  • UNAVAILABLE: Die aufgenommene Ansage wird so konfiguriert, dass diese abgespielt wird, sobald eine „Umleitung nach Zeitüberschreitung“ eintritt oder eine „Immer“-Umleitung aktiv ist. Intern ist die Umleitungsart „Immer“ eine Umleitung „nach 0 Sekunden“, daher gibt es nur diese zwei Varianten.

  • BOTH: Die aufgenommene Ansage wird so konfiguriert, dass diese in beiden Fällen abgespielt wird.

Ansagedatei

Es kann optional eine Ansage vor Aufnahme der Voicemail-Ansage definiert werden, zum Beispiel eine Erklärung für den Anwender. Die gewünschte Ansage kann hier im .wav-Format hochgeladen werden.

Aufnahmeeinstellungen

Die Aufnahmen werden durch Auflegen, Stilleerkennung oder nach maximaler Dauer beendet (Angaben in Sekunden). Das Beenden der Aufnahme durch Stille oder Maximaldauer wird mittels Besetztzeichen signalisiert.

Hinweis

Alte Aufzeichnungen werden nicht gelöscht, es werden nur die neuen Ansagen aufgenommen und benutzt. Die Dateien werden im Verzeichnis /var/spool/asterisk/announce der Anlage abgelegt.

Extras

extras

Mailbox

Aktiviere diese Option um die aufgenommene Ansage einer Gruppen-Mailbox, anstelle eines Benutzers zuzuordnen. Bitte wähle dazu noch die gewünschte Gruppe aus.

Von außen setzen

Die Ansage kann auch durch einen Anruf von extern gesetzt werden, dazu ist die Eingabe einer PIN via DTMF Code erforderlich. Bitte gebe tabellarisch die PIN und die zugehörige Login-ID der Benutzer ein. Wenn die Ansage einer Gruppe geändert werden soll, reicht es aus, wenn eine einzige PIN aus der Liste mit der Eingabe übereinstimmt.

Warnung

Für die PIN-Abfrage muss zwingend eine Ansage hochgeladen werden.

Text-To-Speech-Ansage

Um die KI Funktion zu nutzen, aktiviere die Checkbox "KI-generierte Ansage verwenden". Im Feld "Text für KI-generierte Ansage" kann nun ein Freitext eingegeben werden, der dann mittels TTS zu einer Ansage konvertiert wird.

Hinweis

Beim ersten Ausführen der KI-Funktion wird auf dem definierten Linux/Docker Server die benötigte KI installiert. Dies kann je nach Hardware und Internetverbindung eine Weile dauern.

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

Warnung

Das Zielverzeichnis muss bereits existieren und es muss der absolute Pfad angegeben 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.4.1
    • Bugfix:
      • Module deaktivieren sich sporadisch nachts

Download

Bitte achte beim Download auf die Kompatibilität zur STARFACE Version!

Mit Klick auf den Downloadlink einer Modulversion öffnen sich ein Fenster mit Installationshinweisen und ein Pop-up-Fenster.

Modul testen:

  • Wir stellen unser Modul 14 Tage kostenfrei zum Testen zur Verfügung.
  • Nach dem Kauf oder Update: Mit E-Mail-Adresse verifizieren. Für die Inbetriebnahme/das Update ist kein Lizenzschlüssel nötig.
  • Wir stellen das Modul als .sfm Datei zur Verfügung.

Zum Download