Music on Hold Class allows users to have a class of files (multiple sound files) that would be played in a specific order.
To set up configuration, please navigate to the ‘Classes’ section and proceed with the following:
Click the ‘Add MOH Class’ button
Populate the following fields:
Enter a desired Class name
(E.g. Test)
Enter the stream URL to be placed as MoH
NOTE: This is optional.
Set the Status to 'ON'
In case you have multiple sound files assigned to MoH class, you can select the order in which you would like these sound files to be played.
You can choose between the following two options:
To set up configuration, please navigate to the ‘Content’ section and proceed with the following:
1. Click the ‘Add New Record’ button
2. Populate the following fields:
Set 'Clip Name' as desired
(E.g. Test)
Upload a file
NOTE: Please note that the compatible format for sound files is: 8Khz, Mono, 16-Bit PCM.
You can use any online free converter for this conversion (e.g. https://g711.org/). When uploading file from the GUI, it must be in .wav or .mp3 format.
Select the desired class
(E.g. default)
Set the Status to 'ON'
When creating a Tenant, every Destination on that Tenant will have the ‘default’ Music on Hold by default. Music on Hold can be changed on a Destination level.
For an Extension, please navigate to:
‘Tenant' -> 'Extensions' -> 'Advanced options' -> under the 'General' section -> 'Music on Hold’
From the drop-down menu, select a preferred MoH class.
NOTE: Users can find the same Settings on the Master Tenant level. However, please note that when adding a MoH class to Master Tenant, it will not be added to Slave Tenants.
To change Default Music on Hold on a System Level that would be applied to every newly created Tenant, users need to change the Default Music on Hold Class.
To change the Default MoH class:
ssh root@IP-ADDRESS-OF-THE-SYSTEM -p2020
Password: enter your user password
(e.g. ssh root@10.1.1.0 -p2020)
mkdir tenant-default chown 555:555 tenant-default
NOTE: When uploading a sound file from the backend, it needs to in an acceptable format for sound files, such as 8Khz, Mono, 16-Bit PCM. Users can use any online free converter for this conversion (e.g. https://g711.org/). It must be in the .gsm format.
Once the File is converted to .gsm, please upload it to a created tenant-default folder:
/opt/pbxware/pw/var/lib/asterisk/sounds/tenant-default/
After uploading the file to the designated folder, users must also change file ownership and permissions for it.
cd /opt/pbxware/pw/var/lib/asterisk/sounds/tenant-default/
chown 555:555 default.gsm
chmod 644 default.gsm
Once this is completed, every Tenant that is created afterwards should have a new MoH file used as default MoH.
NOTE: Please note that this action does not affect the existing Tenants. For each existing Tenant, users would need to manually change the default Class for its Destinations.
MoH can be set as a ringtone on Extensions, Ring Groups. For a Ring Group, it can be changed under 'Advanced Options'.
In order to set up configuration successfully, please do the following:
Navigate to 'Extensions' -> 'Ring Groups'
Click the 'Show Advanced Options'
Navigate to the 'Dial Options' field
NOTE: To play music to ring group callers, please set this field to 'm(tenant-number-$CLASS)', where m = MOH class e.g. m('m-150-default'), (150-tenant number).