How to change Voicemail PIN from a phone

The Article describes the procedure that allows users to dial a specific number from their phone to change their voicemail password.

Created: March 2020

Permalink: https://wildix.atlassian.net/wiki/x/dQDOAQ

Introduction

Currently there is no built-in way for a user to change a voicemail password from a phone. This is because the VM password is derived from the web password (password for Collaboration). This is fine in most of the cases, but there could be scenarios where a user does not access Collaboration at all (Basic licenses). In such cases, all a user has is a hard phone. This means that there must be another way configured for them to change the VM PIN. The procedure described here allows users to dial a specific number from their phone to change their voicemail password.

Prerequisites

Sounds

There are some sounds that need to be created, these sounds are for giving users instructions during the process of changing the voicemail password:

  • vmpass

Create (either using TTS or uploading a file) a new sound called “vmpass”.  This sound is to indicate to the user to enter the current voicemail password (e.g. please enter your current voicemail password,).

  • getnewpass

Create (either using TTS or uploading a file) a new sound called “getnewpass”.  This sound is to indicate to the user to enter a new voicemail password (e.g. Please enter a new 5-digit password.)

  • again

Create (either using TTS or uploading a file) a new sound called “again”.  This sound is to be played after “getnewpass” is played. It will be used to have the caller re-enter the password.

All of the sounds should be named as indicated.  If different names or directories are used please adjust corresponding references within the Dialplan configurations shown below.

Script

There is a required script called “changePIN.php” that you need to upload to your system and place it in /var/www/scripts directory. You can of course put the script in some other suitable place if you choose but you will need to adjust the corresponding entry in “execute” number within “changeVMPIN” procedure if you do so. Make sure that “changePIN.php” has execution permissions and is owned by WMS user.

Download the script:

  • for WMS 6 systems

     

  • for WMS 5 systems

Dialplan Configuration

A Dialplan called “changeVMPIN” was created to allow users to dial a number to change their voicemail password. Within this dial plan the access number is 7777 but you can use any number you desire  as pilot number on your Dialplan.  

Import the Dialplan to your system:

Download the Dialplan: 



Then create the following entry in users Dialplan (or any Dialplan your users are using):

changeVMPIN Dialplan procedure consists of:

Recap of Setup Steps

  1. Create sounds in the system
  2. Download the “changePIN.php” script and copy it to the system under the /var/www/scripts directory.
  3. Make the script file executable and change it’s ownership to WMS
  4. Download the dial plan and create a pilot number to jump to ext 7777 on such Dialplan.