4.3. Dialplan applications
Action: The caller is prompted to leave a voice
message.
The VoiceMail()
command is always called from the
dialplan (extensions.conf
). For example:
exten => 2000,2,VoiceMail(2000,u)
VoiceMail(mailbox[@context][,u|b|s])
mailbox
This is the mailbox number. This does not have to be
the same as the extension the caller dialled; nevertheless, this
is a sensible practice, particularly in larger
installations.
@context
Mailboxes may be implemented in a specific context. If
no context is provided, the [default] context is used.
If the caller presses "0" while listening to the
prompt, the application will jump to extension "o" (the small
letter o) in the specified context. |
If the caller presses "*" while listening to the
prompt, the application will jump to extension "a" (the small
letter a) in the specified context. |
[u|b|s]
u
causes the "unavailable" message to be played.
The pathname for this message is
/var/lib/asterisk/sounds/vm-isunavail.gsm
[]
b
causes the "busy" to be played. The pathname for
this message is
/var/lib/asterisk/sounds/vm-rec-busy.gsm.
s
suppresses playback of the "unavailable" or
"busy" notifications, plays a beep, and begins
recording.
If there is no mailbox configured in
voicemail.conf
for the given number but there is
a n+101 priority, Asterisk jumps to this priority and continues
executing there.
Action: Lets users listen to their voicemail messages and
record prompts.
The VoiceMailMain()
command is always called from
the dialplan (extensions.conf
). For
example:
exten => 300,1,VoiceMailMain()
VoiceMailMain([mailbox][@context][,s|p|g(#)])
mailbox
This is the mailbox number. If no mailbox number is
provided, Asterisk prompts for it.
@context
specifies the voicemail context (in
voicemail.conf
) for the mailbox.
[s|p|g#]
s
Disables the password requirement.
p
The user is asked for a mailbox number. The
number entered is attached as a suffix to the contents of
[mailbox]; for example, if the user enters 123,
[mailbox]123 is called. This lets you easily configure
mailbox groups.
g(#)
Adjusts the gain (in decibels) when recording
voicemail prompts.
A complete description of the voice menus for
VoiceMailMain()
is difficult because they depend on the
installed prompts. The main functions are described below.