Difference between revisions of "Hangupcause Sounds"

From Kolmisoft Wiki
Jump to navigationJump to search
 
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
= Description =  
= Description =  


MOR returns [[Hangupcause Codes | error codes]] when call fails.
MOR returns [[Hangupcause Codes | error codes]] when a call fails.


They are written in [[Asterisk CLI]]. Also these codes are visible in Call List near each call.
The codes are written in [[Asterisk CLI]]. The codes are visible in the Call List near each call.


To make it even simpler, MOR can play associated audio when some error happens.
To make it even simpler, MOR can play associated audio when some error happens. To enable the audio, make '''play_hgc_audio = 1''' in [[mor.conf]] and [[How to restart Asterisk server | restart Asterisk]].


To enable it make '''play_hgc_audio = 1''' in [[mor.conf]] and [[How to restart Asterisk server | restart Asterisk]].
If this setting is equal to 2, then sound files will be played for ALL error codes (sound files for these error codes are not included into MOR) (''This option is available starting from [[MOR_10_documentation | MOR 10]]''.)


This setting is available from the start to help new users to start with MOR and get instant feedback about failed calls.
This setting is available to help new users start with MOR and get instant feedback about failed calls.


Sound files are stored in ''/var/lib/asterisk/sounds/mor/hgc''
Sound files are stored in ''/var/lib/asterisk/sounds/mor/hgc''. More information available [[ Hangupcause_Sounds#How_to_change | here]]


'''IMPORTANT!''' For production use this setting should be disabled because call is answered in order to play these sounds and dialer has to pay for the call.
'''IMPORTANT!''' Sound messages are delivered using early media, so it might not work in all situations.
 
MOR will send 183 with Early media only if the '''Progressinband''' setting in Originator (DID provider or Device) is NOT set to '''Never''', which is a default setting.
<br>[[File:Hgc_progressinband.png]]<br>
 
If '''Progressinband''' is set to default '''Never''', when most likely a customer will hear only a ringing signal instead of the message.
 
More information about '''Progressinband''' available [[ Providers#Advanced | here]].




Line 25: Line 32:
and [[How to restart Asterisk server | restart Asterisk]].
and [[How to restart Asterisk server | restart Asterisk]].


To check if this setting is disabled you can enter in [[Asterisk CLI]]:
To check whether this setting is disabled, you can enter in [[Asterisk CLI]]:


  mor show status
  mor show status
Line 49: Line 56:
= How to change =
= How to change =


Sound files are stored in ''/var/lib/asterisk/sounds/mor/hgc'' overwrite them with sound files ([[Sound_files#Converting |converted to Asterisk readable format]]).
Sound files are stored in ''/var/lib/asterisk/sounds/mor/hgc'' directory.  If directory does not exist, please create it manually using ''mkdir -p /var/lib/asterisk/sounds/mor/hgc''. Sound file's filename should follow format hgc_{actual_hgc_code}.wav, for example, in order to play sound file for HGC 201, sound filename should be hgc_201.wav.  Before uploading to directory ''/var/lib/asterisk/sounds/mor/hgc'' sound files should be [[Sound_files#Converting |converted to Asterisk readable format]].


<br><br>
<br><br>

Latest revision as of 12:53, 10 May 2023

Description

MOR returns error codes when a call fails.

The codes are written in Asterisk CLI. The codes are visible in the Call List near each call.

To make it even simpler, MOR can play associated audio when some error happens. To enable the audio, make play_hgc_audio = 1 in mor.conf and restart Asterisk.

If this setting is equal to 2, then sound files will be played for ALL error codes (sound files for these error codes are not included into MOR) (This option is available starting from MOR 10.)

This setting is available to help new users start with MOR and get instant feedback about failed calls.

Sound files are stored in /var/lib/asterisk/sounds/mor/hgc. More information available here

IMPORTANT! Sound messages are delivered using early media, so it might not work in all situations.

MOR will send 183 with Early media only if the Progressinband setting in Originator (DID provider or Device) is NOT set to Never, which is a default setting.
Hgc progressinband.png

If Progressinband is set to default Never, when most likely a customer will hear only a ringing signal instead of the message.

More information about Progressinband available here.


How to disable

In order to disable these audio prompts in mor.conf set:

play_hgc_audio = 0

and restart Asterisk.

To check whether this setting is disabled, you can enter in Asterisk CLI:

mor show status

It should show as disabled:

CLI> mor show status

MOR billing and Routing application status
--------------------------------------------------
Version: 8.1.10
Server ID: 1
Active calls now/limit: 0/1000
Global call timeout: 7200 s
Use LCR Partials: 1
Check banned CLIs: 1
Use Speed Dials: 1
>>> Play HGC Audio: 0 <<<
Use Flat-Rates: 1



How to change

Sound files are stored in /var/lib/asterisk/sounds/mor/hgc directory. If directory does not exist, please create it manually using mkdir -p /var/lib/asterisk/sounds/mor/hgc. Sound file's filename should follow format hgc_{actual_hgc_code}.wav, for example, in order to play sound file for HGC 201, sound filename should be hgc_201.wav. Before uploading to directory /var/lib/asterisk/sounds/mor/hgc sound files should be converted to Asterisk readable format.



See also