Music On Hold

Overview

Music on hold (MOH) is the business practice of playing recorded music/message to fill the silence that would be heard by telephone callers who have been placed on hold.
The Music on Hold (MOH) is intended to reassure callers that they are still connected to their calls.

Configuration

By default, in Vega when a caller is put on hold they hear silence. The Vega supports the playing of Music on Hold (MoH) to the held party.
Vega gateways support the draft-ietf-sipping-service-examples-11 method of supplying music on hold. This is easily configured through VEGA GUI.

Music on Hold configuration is present within “SIP Music on Hold” option under “SIP Tab” of “Expert Config Section” (i.e. Expert Config Section-> SIP -> SIP Music on Hold) as show below:

Music on Hold(MoH) configuration can be divided into two different step:

  1. Music on Hold mode configuration

  2. SIP Music Server Configuration

Music on Hold mode configuration

In order to enable Music on Hold (MoH), MOH mode need to be configured as “sipping_service_11”.
Selecting mode as “sipping_service_11” enables “draft-ietf-sipping-service-examples-11” method of supplying music on hold.
This configuration is present within in SIP Music on Hold Configuration page as shown below:

The draft-ietf-sipping-service-examples-11 method operates as shown below:

The Vega responds to 1xx provisional responses by opening media if an SDP body has been received.

SIP Music Server Configuration

VEGA allows us to configure itself/any other device as a MOH server.
In order to setup Music On Hold server VEGA requires:

  1. URI used to construct the SIP message

  2. IP / Hostname and its IP port create the IP address to send the SIP messages to
    as shown below:

          

In order to configure VEGA itself as MOH server the ip needs to be change to “127.0.0.1” (i.e. loop[back ip address or VEGA self ip) in URI and IP/HOSTNAME as stated in above figure/example.
Vega comes with a built in default hold music sound file. You can easily add your own music or sound files to the system by uploading them in .wav (mu-law) format.

Music On Hold File Upload

Hold Music File can be uploaded on to VEGA using VEGA GUI as present within “Upload/Download File” Option under “System Tab” of “Expert Config section” (i.e. Expert Config Section-> System-> Upload/Download File) as shown below:

Once file is successfully upload VEGA GUI will display proper result message as shown below:

VEGA reboot is required in order to properly load new Hold Music as uploaded.

NOTE:

  1. VEGA as Music On Hold server will only support G711 Mu-law calls to play Hold Music.

  2. Uploaded files must be in G711 Mu-law format and without any headers (like Artist Name, Album/Track Title etc. within it.

We can remove the header from music file using Audacity tool. We can get the Audacity tool from http://www.audacityteam.org/download/

Removing header from music file is explained here: 

 

Return to Documentation Home I Return to Sangoma Support