Administration

UCX Administration
Voicemail Settings

Overview

This page allows you to control various aspects of your voicemail system and individual voicemail account settings. To access the page, perform the following steps:

  1. From the PBX tab, select PBX Configuration
  2. From the left side column, select Voicemail Settings

At the top of the page, System View Links provide access to four different system level settings, where Usage is the default page shown. On the right hand side you will see a list of existing voicemail boxes on your system. Clicking any of these boxes will bring up the page to control the account level settings.

System View
  1. Usage
  2. Dialplan Behavior
  3. Settings
  4. Timezone Definitions
Account View
  1. Settings
  2. Usage
Configure the system level settings first, these will apply to all voicemail accounts. Then configure the individual account level settings (if required), these will override the system level settings.

System View

1 – Usage

The page provides a system level usage of voicemail resources and allows the administrator to easily delete data.

Field
Description
Number of AccountsTotal number of accounts (activated / unactivated / disabled).
Number of Messages

Total number of messages (inboxes / other folders).

Delete will remove all messages.

Recorded Names

Number of recorded name greetings.

Delete will remove all recorded names.

Unavailable Greetings

Number of recorded unavailable greetings.

Delete will remove all unavailable greetings.

Busy Greetings

Number of recorded busy greetings.

Delete will remove all busy greetings.

Temporary Greetings

Number of recorded temporary greetings.

Delete will remove all temporary greetings.

Abandoned Greetings

Number of abandoned greetings. Greetings recorded by the user but not accepted. The sound file remains on the disk but is not used as a greeting.

Delete will remove all abandoned greetings > 1 day old.

Storage UsedDisk space currently in use by the voicemail system.

2 – Dialplan Behavior

This page controls a few key voicemail settings and the VmX locater settings.

FieldDescription
General Dialplan Settings
Disable Standard PromptCheck this box to disable the standard voicemail instructions that follow the user recorded message.
Direct Dial ModeThe greeting to be played when direct dialing voicemail.
Voicemail Recording GainThe amount of gain to amplify a voicemail message that is being recorded. The gain is in decibels, which doubles for every 3 db.
Operator Extension

Default number to dial when the user presses the “0” key, if enabled. This can be any number, including an external number. There is no validation and hence should be tested after configuration.

This is frequently referred to as the “dial 0” operator number.

Advanced VmX Locater Settings
Msg TimeoutTime to wait after the recorded message has been played before timing out.
Times to Play MessageNumber of times to play the recorded message. One attempt means it will not repeat. More than one attempt means the message will repeat after timing out.
Error Re-triesNumber of times to repeat the message upon receiving an undefined option. One retry means it will repeat once after the initial failure.
Disable Standard Prompt after Max LoopsIf Max Loops is reached and the call goes to voicemail, checking this box will disable the standard voicemail prompt that follows the user’s recorded greeting.
Disable Standard Prompt on ‘dovm’ ExtensionIf the special advanced extension of “dovm” is used, checking this box will disable the standard voicemail prompt that follows the user’s recorded greeting.

3 – Settings

There is a long list of parameters that you can set on this page. Additional information is provided for the more commonly used settings.

Voicemail to Email and Greetings

Field
Description
attachOption to attach voicemails to email.
emailbody

This is the text that will appear in the email sent to users. Typically you would want to change the placeholder AMPWEBADDRESS to the actual IP address or hostname of your UCX Server.

${VM_NAME},\n\nThere is a new voicemail in mailbox ${VM_MAILBOX}:\n\n\tFrom:\t${VM_CALLERID}\n\tLength:\t${VM_DUR} seconds\n\tDate:\t${VM_DATE}\n\nDial *97 to access your voicemail by phone.\nVisit http://AMPWEBADDRESS/recordings/index.php?login=${VM_MAILBOX} to check your voicemail with a web browser.\n
 
See Voicemail to Email for usage.
emailsubjectThe subject of the notification email sent to the user.
See Voicemail to Email for usage.
envelopeTurn on envelope playback before message playback.
externnotifyThe external application to be notified.
See Unified Messaging for M1/CS1000 Users for usage.
forcegreetingsForce new users to record greetings.
forcenameForce new users to record their name.and change password.
format

Format(s) used for recording voicemail. Multiple codes can be entered using the pipe [ ]. if using IMAP storage then only the first one specified will be used. Emails are also sent with the first codec listed.  Formats are:

  • wav49 (compressed .WAV file)
  • gsm (compressed with same characteristics as wav49)
  • wave (uncompressed .wav file)
fromstringThe name of the FROM email address of the notification email sent to the user.
See Voicemail to Email for usage.


Customizing control keys during Message Playback

You can customize the keys used for message control during message playback. The key values must be single digit.

FieldDescription
listen-control-forward-keyKey to forward the message.
listen-control-pause-keyKey to pause the message..
listen-control-restart-keyKey to restart the message.
listen-control-reverse-keyKey to rewind the message.
listen-control-stop-keyKey to stop the message.


Setting maximum and minimum values in messages

Note that three of the values below (maxsecsmaxsilenceminsecs) and one value in the Voice mailbox operational settings grouping (silencethreshold) set boundaries on the size of the messages left in voicemail. Use care in adjusting these parameters. E-MetroTel recommends to leave the silencethreshold value at the deault unless it is truly required for dealing with unusual amounts of background noise, and that adjusting the value should be done in minor increments if changes are truly necessary.

Field
Description
maxmsgMaximum number of messages per folder. The maximum value is 9999. The default value is 100.
maxsecsMaximum message length (in seconds). When the recording duration reaches the configured maxsecs value, the recording is ended and the voicemail message is saved. The default value is 240 seconds.
maxsilenceDuration of continuous silence (in seconds) that ends the recording of a voicemail message. When silence detected during a recording reaches the maxsilence value, the recording is ended.  Note: When recording is ended due to maxsilence, the silence is removed from the voicemail message before the minsecs check is performed.
minpasswordMinimum password length. When a user sets or changes their password from a phone, this minimum length is checked.
minsecsMinimum message length (in seconds). If the recording is shorter than the configured minsecs value, the voicemail message is not saved. The default value is 2 seconds.
notifymissedSends a missed call notification email when the caller abandons a voicemail session without leaving a message. Default is no, indicating no message will be sent.


Voice mailbox operational settings

Field
Description
reviewAllow sender to review/re-record their message before saving it.
sayextensionSay the extension number as part of the default unavailable and busy messages
serveremailThe FROM email address of the notification email sent to the user.
See Voicemail to Email for usage.
silencethresholdThe threshold used to determine if a voice frame contains silence or noise/tone/speech. The default silencethreshold value is 256, which is also the minimum value. The maximm value is 32767.  Note: Increasing the silencethreshold value above the default value (256) can be useful in order to properly detect silence on calls with an unusual amount of background noise. Setting this value too high may lead to problems with audio detection.E-MetroTel recommends to leave the value at the deault unless it is truly required for dealing with unusual amounts of background noise, and that adjusting the value should be done in minor increments if changes are truly necessary.
skipmsNumber of milliseconds to skip forward/backward when fast forwarding and rewinding in message playback.
externpasscheckThis field points to a script that will perform checks on the password. The default value is /usr/bin/ucx_vm_check_password.
This script will perform the following complexity checks:
– Cannot be shorter than 2 digits
– Cannot be the same as the mailbox (extension) number
– Cannot contain only one digit (e.g. 111111, 222222, 0000, etc.)
– Cannot contain the same digit from the beginning or from the end with the exception of the last/first digit (e.g. 111112, 211111, 1000, 007, etc.)
– Cannot be in sequences (e.g. 012345, 1234, 987654, 3210, etc.)

4 – Timezone Definitions

Timezone definition specifies how the voicemail system announces the time. The definitions that you specify will overwrite the defaults.

Field
Description
New NameEnter a name for the timezone
New Timezone DefinitionTime announcement for message playback

The format of the timezone defintition is: timezone| values

A list of supported time zone names is available in the TZ column of the time zone table on this page: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.

The supported values are:

  • ‘filename’ – the name of the sound file in single quotes
  • variable – the supported variables are listed on the page

Examples of Timezone Definitions:

  • America/New_York| ‘vm-received’ Q ‘digits/at’ IMp
    [Note: The timezones definitions need to be valid entries from the website referenced above.]
  • Asia/Shanghai| ‘vm-received’ a d b ‘digits/at’ HM

USEFUL TIP

You can specify the timezone used by an extension in 2 places:

  • From the Voicemail Settings page, select the voicemail account from the top right-hand corner, enter the timezone name in the Timezone field.
  • From the Extensions page, under Voicemail section, specify the timezone (tz) in the VM Options field. For example: tz=Eastern

  • Account View

    Select an extension on the right hand side to view the account level settings. Settings at the account level will overwrite the system level settings.

    1 – Settings

    2 – Usage

    Contents