Im Bereich [general]
werden allgemeine
Konfigurationen des Voicemailsystems vorgenommen. Es stehen folgende
Optionen zur Verfügung:
attach =
[yes|no]
Legt fest, ob an die Benachrichtigungs-E-Mails an die Nutzer auch die Sprachnachricht als Sounddatei angehängt wird. Default:
yes
. Normalerweise wird das erste unterformat
eingestellte Format verwendet.Beispiel:
attach = no
callback =
[Context]
Legt einen Context fest, der für Rückrufe aus dem System benutzt wird. Ist dieser Wert nicht gesetzt, was per Default der Fall ist, dann kann der User keine Rückrufe aus dem Voicemailsystem machen.
Beispiel:
callback = intern
charset =
[Zeichensatz]
Gibt den Zeichensatz (Charset) vor, in dem die E-Mails vom Voicemailsystem kodiert werden.
Beispiel:
charset = ISO-8859-1
delete =
[yes|no]
Definiert, ob eine Sprachnachricht nach dem Versenden per E-Mail automatisch gelöscht werden soll. Dies spart Festplattenplatz auf dem Server, falls man Sprachnachrichten nur per E-Mail empfangen will.
Beispiel:
delete = yes
directoryintro =
[Dateiname]
Definiert eine Sprachdatei innerhalb des Default-Verzeichnisses
/var/lib/asterisk/sounds/
, die anstatt der normalen Datei für das Dial-by-Name-System abgespielt wird (siehe Abschnitt 5, „Telefonbuch (Dial-by-Name)“).Beispiel:
directoryintro = intro-telefonbuch
emailsubject =
[Text der Betreffzeile]
Definiert den Betreff (Subject) einer Benachrichtigungs-E-Mail. Für Informationen über Variablen siehe
emailbody
.Beispiel:
emailsubject = Neue Sprachnachricht von ${VM_CALLERID}
pbxskip =
[yes|no]
Standardmäßig schreibt Asterisk am Anfang der Betreffzeile der E-Mail-Benachrichtigung über eine Sprachnachricht den Text
[PBX]:
Dies kann mityes
unterdrückt werden.Beispiel:
pbxskip = yes
emailbody =
[Text der Email]
Definiert den E-Mail-Body[98] einer Benachrichtigungs-E-Mail (maximal 512 Zeichen).
Im Betreff und im Body einer solchen E-Mail kann auf folgende Variablen zugegriffen werden:
Beispiel:
emailbody = Hallo ${VM_NAME},\n\nSie haben eine neue Nachricht von ${VM_CALLERID} in Mailbox ${VM_MAILBOX}.
[99]serveremail =
[Absenderadresse]
E-Mail-Adresse, die als Absender der E-Mail vom Voicemailsystem an den User eingestellt wird.
Beispiel:
serveremail = voicemail@apfelmus-gmbh.de
fromstring =
[Absendername]
Definiert den Absender (
From
-Header) in E-Mails vom Voicemailsystem.Beispiel:
fromstring = AB
mailcmd =
[Shell-Befehl]
Definiert das Programm (mit absolutem Pfad und ggf. Parametern), das zum Versenden von E-Mails benutzt werden soll. Default:
/usr/sbin/sendmail -t
Beispiele:
mailcmd = /usr/sbin/sendmail -t
mailcmd = /usr/exim/bin/exim -t
externnotify =
[Shell-Befehl]
Definiert ein Programm (mit absolutem Pfad), das von Asterisk aufgerufen wird, wenn eine neue Sprachnachricht für einen User vorliegt.
Beispiel:
externnotify = /usr/bin/local/mach-was.sh
externpass =
[Shell-Befehl]
Definiert ein Programm (mit absolutem Pfad), das von Asterisk aufgerufen wird, wenn ein User sein Passwort geändert hat.
Beispiel:
externpass = /usr/bin/local/mach-was.sh
forcegreetings =
[yes|no]
Definiert, ob ein User vom System dazu gezwungen wird, beim ersten Benutzen des Systems eine Begrüßungsnachricht aufzunehmen. Default:
no
Beispiel:
forcegreetings = no
forcename =
[yes|no]
Definiert, ob der User vom System dazu gezwungen wird, bei der ersten Nutzung seinen Namen aufzunehmen. Default:
no
Beispiel:
forcename = yes
format =
[gsm|wav|wav49]
Listet die Codecs auf, mit denen eine Sprachnachricht abgespeichert werden soll. Werden mehrere Codecs aufgeführt, werden auch mehrere Dateien gespeichert. Das kann im Extremfall zu Platzproblemen auf der Festplatte führen. Der Vorteil liegt darin, dass bei einer Abfrage die Nachricht nicht noch einmal neu kodiert werden muss, falls der Abfragende mit einem anderen Codec abfragt, als mit dem, in dem die Nachricht bereits gespeichert wurde.
Bei aktiviertem
attach
wird das erste Format dieser Liste für E-Mail-Anhänge verwendet.Beispiele:
format = gsm|wav
Jede Sprachnachricht wird im GSM- und im WAV-Format abgespeichert.
format = wav
Jede Sprachnachricht wird nur im WAV-Format abgespeichert.
Achtung Wird diese Einstellung im laufenden Betrieb verändert, müssen vorher vom System angelegte Sounddateien manuell gelöscht werden.
searchcontexts =
[yes|no]
Standardmäßig werden Voicemailboxen nur im angegebenen Context gesucht. Mit diesem Schalter kann man das Suchverhalten auf alle Contexte erweitern. Default:
no
Beispiel:
searchcontexts = no
maxmsg =
[Anzahl Nachrichten]
Definiert die maximale Anzahl an Sprachnachrichten in einer Voicemailbox. Default:
100
. Danach können keine neuen Nachrichten mehr aufgenommen werden, und der Anrufer hört die Nachricht/var/lib/asterisk/sounds/vm-mailboxfull.gsm
[100].Beispiel:
maxmsg = 50
maxmessage =
[Länge in Sekunden]
Definiert die maximale Länge einer Sprachnachricht in Sekunden. Default: unendlich
Beispiel:
maxmessage = 120
minmessage =
[Länge in Sekunden]
Definiert die minimale Länge einer Sprachnachricht in Sekunden. Default:
0
Beispiel:
minmessage = 5
maxgreet =
[Länge in Sekunden]
Definiert die maximale Länge einer Begrüßungsnachricht in Sekunden. Default: unendlich
Beispiel:
maxgreet=240
maxsilence =
[Länge in Sekunden]
Definiert die Anzahl der Sekunden an Stille, die das System wartet, bevor es davon ausgeht, dass die Nachricht zu Ende gesprochen wurde.
Beispiel:
maxsilence=10
silencethreshold =
[Schwellenwert]
Definiert, was für Asterisk bei der Einstellung
maxsilence
Stille (also Silence) ist. Je niedriger dieser Wert ist, desto höher ist die Empfindlichkeit. Default:128
[101]Beispiel:
silencethreshold = 50
maxlogins =
[Anzahl]
Definiert die maximale Anzahl von fehlerhaften Einlogversuchen (falsches Passwort durch den User), bevor Asterisk auflegt. Default:
3
Beispiel:
maxlogins = 3
skipms =
[Millisekunden]
Setzt die Anzahl an Millisekunden, um die während des Abhörens einer Sprachnachricht mit den Tasten für weiter und zurück in der Nachricht gesprungen wird. Default:
3000
Beispiel:
skipms = 6000
usedirectory =
[yes|no]
Erlaubt es dem User von Voicemailboxen, die Einträge eines Dial-by-Name-Systems zur Weiterleitung von Nachrichten zu benutzen. Default:
no
Beispiel:
usedirectory = yes
saycid =
[yes|no]
Definiert, ob die Telefonnummer des Anrufers beim Abrufen der Nachrichten angesagt werden soll. Default:
no
Beispiel:
saycid = yes
cidinternalcontexts =
[context,context,...]
- Legt die Contexte fest (durch Kommata getrennt), die beim Abrufen einer Voicemail-Nachricht als intern gelten, für die also z.B. nur die Durchwahl (Extension) als Caller-ID angesagt wird. Default: keine
pagerfromstring =
[Absendername]
Analog zu
fromstring
für Nachrichten an Pager.Beispiel:
pagerfromstring = Apfelmus GmbH
pagersubject =
[Betreff]
Analog zu
emailsubject
für Nachrichten an Pager.Beispiel:
pagersubject = Neue Voicemail
pagerbody =
[Absendername]
Analog zu
emailbody
für Nachrichten an Pager.Beispiel:
pagerbody = Neue Voicemail in Mailbox ${VM_MAILBOX} von ${VM_CALLERID}.
Neben den hier aufgeführten Parametern gibt es noch weitere,
die genannten sind jedoch die wichtigsten für gängige Konfigurationen.
Eine Auflistung aller verfügbaren Parameter findet sich in der Datei
voicemail.conf
. In der Grundinstallation sind dort
alle Parameter mit einer kurzen Beschreibung enthalten.
[98] Textteil einer E-Mail
[99] Es muss alles in eine Zeile geschrieben werden. Durch
\n
wird in der E-Mail ein Zeilenumbruch
eingefügt.
[100] Pfad abhängig von der Installation, z.B. auch
/usr/share/asterisk/sounds/
[101] Es lässt sich selbst im Source-Code von Asterisk keine Information finden, in welchem Rahmen sich dieser Wert sinnvoll bewegen kann (es handelt sich um einen Int). Ggf. ist also Ausprobieren erforderlich.
Version 1.2, November 2002
Neue Version verfügbar
Sie betrachten gerade die alte Version des Buches (Version 1.0). Wir empfehlen Ihnen für Asterisk 1.4 und 1.6 die neue Version des Buches.
Asterisk-Tag 2008
Lernen Sie Mark Spencer (den Erfinder von Asterisk) kennen! Viele Vorträge, Case-Studies und Workshops rund um das Thema VoIP. Asterisk-Tag.org