Difference between revisions of "Hangupcause Sounds"

From Kolmisoft Wiki
Jump to navigationJump to search
 
(14 intermediate revisions by 3 users not shown)
Line 1: Line 1:
MOR returns [[Hangupcause Codes | error codes]] when call fails.
= Description =


They are written in [[Asterisk CLI]]. Also these codes are visible in Call List near each call.
MOR returns [[Hangupcause Codes | error codes]] when a call fails.


To make it even simpler, MOR can play associated audio when some error happens.
The codes are written in [[Asterisk CLI]]. The codes are visible in the Call List near each call.


To enable it make play_hgc_audio = 1 in [[mor.conf]] and [[How to restart Asterisk server | restart Asterisk]].
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 setting is available from the start to help new users to start with MOR and get instant feedback about failed calls.
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]]''.)


'''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.
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.
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