Voicemail profiles determine how long Feature Server keeps voicemails for a user or user group before deletion. Voicemail profiles use a Class of Service model to enable the quick assignment of voicemail notifications and retention limits to user groups or specific collections of users.
You can create profiles that set retention limits of 1 to 10,000 days, or use No Limits to set voicemails not to expire. You can effectively disable voicemail profiles by keeping the default Retention Limit value of the System Profile, No Limits, and assigning no other profile to your users.
The System Profile applies only when none of the users or user groups assigned to a mailbox has an assigned profile.
A new retention limit value in an assigned profile applies to all subsequent voicemail deposits in mailboxes associated with users and user groups the profile is assigned to. To apply a new value or a newly assigned profile to previously deposited voicemails, you run the Apply Message Retention Limits script. You can also run the script when you assign a new profile to a user or user group.
Managing voicemail profiles
To create and manage voicemail profiles:
- Log into GAX as an administrator (GAX IP address:port/gax). Under Operations > SIP Voicemail & Call Settings > Voicemail, select Profiles.
- To create a new profile, select New. To edit an existing profile, select it from the list.
- The Retention Limit column displays the limit for each profile, in number of days. The Email Notification and Http Notification columns display a check mark for the profiles that have those notification protocols enabled.
- Uniquely name or rename the profile to identify the group or type of users to associate with it. For example: Tier 1 agents or Branch Office Wealth Managers. These names do not need to map directly to your defined user groups, because you can assign profiles to any individual or collection of users.
- Set a Retention Limit, in number of days from 1 to 10000. Select No Limits to retain voicemails until the user deletes them manually.
- Optionally, set up email or web notifications.
- Assign profiles to users and user groups.
- If you have assigned new profiles or reassigned profiles and want to apply them retroactively, run the Apply Message Retention Limits script.
You can assign voicemail profiles directly to individual users or user groups, and to collections of users through Bulk Assignment.
|A single user||
|A user group||
|Multiple individual users||
Applying retention limits to existing voicemails
To apply new or changed retention limits to existing voicemails, you must run the applyMessageRetentionLimits.py python script. The script can run in two modes: information mode, which only reports on mailboxes and their associated voicemail profiles, and execution mode, which applies the new or changed retention limits. Information mode enables you to resolve conflicts (where one mailbox is associated with multiple users or user groups with different profiles) before running in the execution mode.
If you previously installed SIP Feature Server 188.8.131.52, you might see two similarly named retention limit scripts in the python folder. The correct script to use is applyMessageRetentionLimits.py.
See Python Scripts for information on how to deploy and run the applyMessageRetentionLimits.py script.
Sample command line
A sample command line to run the script:
java -jar <jython-version>.jar applyMessageRetentionLimits.py script input parameters
where the script input parameters are:
- -H Identifies the Cassandra host name (default: localhost)
- -p Identifies the Cassandra port (default: 9160)
- -o Names the output file (default: result.log); changing this value enables you to store multiple log files
- -e Activates the execution mode
- -y Overwrites an existing output file of the name specified by the -o parameter (optional, but when you omit this parameter, the script does not successfully complete if an output file already exists)
You set up Voicemail notifications in the Notifications tab.
To configure email and web notifications for a selected or new profile:
- To enable email (SMTP) notifications, set Email Notification Enabled to Yes.
- To allow users and user group administrators to turn email notifications on or off for themselves, and to specify the recipient email address, set Email Notification Allow User Setup to Yes. A value of No means that only administrators can control user and user group settings.
- To enable web (HTTP) notifications, set Web Service Notification Enabled to Yes.
- To allow users and user group administrators to turn web notifications on or off for themselves, and to specify the recipient phone number, set Web Service Notification Allow User Setup to Yes. A value of No means that only administrators can control user and user group settings.
- Complete the notification settings that apply to your notification method, email (SMTP) or web (HTTP).
|Applies to||Setting||Values (default value in bold)||Description|
|SMTP||Email From Address||user@domain||The email address from which you want to send notifications; if you are using the TLS or SSL protocol, you must type the same address that you specified as the username in the SMTP configuration options section in Genesys Administrator.|
|SMTP||Email Subject||Genesys Voicemail Notification: New Message from <CallerID>, any subject line||The Subject line of the notification email. It can contain any of the parameter tokens available in the Email Message Body.|
|SMTP||Email Message Body||Mailbox <MailboxID> has a new message from <CallerID>, any text|| The body of the notification email. It can contain any of the following parameter tokens. To insert a parameter, type < and select from the list, or type the tag name surrounded by brackets <tagname>. The message also includes any static text you type.
|HTTP||Web Service URL||none, Web Service URL||The URL of the web service you set up to handle HTTP notifications. Use the format: http://host:port|
|HTTP||Web Service Message Parameters||
| The parameter tokens available for the web notification message, formatted as key-value pairs (such as caller=<CallerID>). Other text is ignored. To insert a parameter, type < and select from the list, or type the tag name surrounded by brackets <tagname>.
|HTTP||Web Service Name||External Notification Service, any text||The name you give to identify your web service; for example, Voicemail Notification Service. The user sees this name as a tab in their user profile.|
|SMTP and HTTP||FS GAX URL||none, GAX URL||The Feature Server Genesys Administrator Extension URL forms the root of the Voicemail Access URL that the user clicks to go directly to the message. Use the format: http://GAX server host:GAX server port/gax/?login#!|
|SMTP and HTTP||Voicemail Access Number||any number||The phone number that users dial to access voicemail. Sets the VoicemailAccessNumber parameter token that you can include in the email or web message body.|