Difference between revisions of "Hangupcause Sounds"
| (13 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
= Description = | |||
MOR returns [[Hangupcause Codes | 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 enable | 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]]. | ||
This | 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 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 [[ Hangupcause_Sounds#How_to_change | 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. | |||
<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]]. | |||
= How to disable = | |||
In order to disable these audio prompts in [[mor.conf]] set: | |||
play_hgc_audio = 0 | |||
and [[How to restart Asterisk server | 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 | |||
<br><br> | <br><br> | ||
- | |||
See also | = 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 [[Sound_files#Converting |converted to Asterisk readable format]]. | |||
<br><br> | |||
=See also= | |||
* [[Hangupcause Codes]] | * [[Hangupcause Codes]] | ||
* [[H323 hangupcause codes]] | * [[H323 hangupcause codes]] | ||
* [[I do not want to hear an error message at the end of the call]] | |||
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.
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.
