Ring Groups

Ring Groups are used to group a number of UADs/Phones into one network destination. Each Ring Group is assigned a network number which once dialed rings all extensions assigned to group.

Table 3.40. Ring Groups

Field Description Example Field Type

Ring Group:

Ring group name

 Accounts Display

Extension:

Ring group extension number

Once user dials this number all destinations assigned to ring group will ring (e.g. 1111)

 Display

Destinations:

Extension numbers assigned to a ring group

Once a ring group number is dialed all destinations set here will ring at the same time (e.g. 1001, 1002, 1003...)

 Display

Last Destination:

Last destination to be called if none of the destination extensions answers the call

 1010 Display

Edit ring group configuration

 Click to edit ring group configuration Button

Delete ring group from the system

 Click to delete a ring group from the system Button


Add/Edit Ring Group

Clicking on 'Add Ring Group' or 'Edit' button will open following ring group options:

Table 3.41. Add/Edit Ring Group

Field Description Example Field Type

Name:

Unique Ring group name

 Set 'Accounts' here to create the same ring group [a-z][0-9]

Extension:

Unique network number associated with the Ring group

When this number is dialed, all extensions associated with it will ring at the same time

 [0-9]

Extensions:

System extensions associated with the ring group

Provide an extension list separated by commas here (e.g. 1001,1002,1003...). When ring group 'Extension' number is dialed, all extensions set here will ring at the same time. NOTE: If all destinations fail after 'timeout', 'Last Destination' will be called.

 [0-9]


Advanced Options

These options fine-tune ring group settings with additional options

Table 3.42. Advance Options

Field Description Example Field Type

Greeting:

Greeting sound file played to callers when Ring group is dialed

Select 'greeting-default-attendant' for example. Any user that calls this ring group will hear this sound file played to them before all ring group extensions are dialed

 Select box

Announce:

Sound file played to caller if his call does not get answered by any of the ring group extensions. NOTE: Sound file must have 'announce-' name prefix (e.g. 'announce-unavailable')

John dials ring group 1000, but nobody answered his call. Sound file selected here will be played to John and then his call will be transferred to 'Last Destination' extension

 Select box

Loops:

How many times to dial all extensions again if nobody answers

John dials Ring group 1000, but nobody answered his call. If this option is set to '2', all extensions will be dialed one more time before transferring his call to 'Last Destination'

 [0-9]

Timeout:

How many seconds will all ring group extensions ring before the call is considered unanswered

This option is set to 20. John dials ring group 1000. All Extensions will ring for 20 seconds before timeout occurs. Depending on whether 'Loop' option is set, all extension will be rung again, or John will be transferred to 'Last Destination'

 [0-9]

Dial Options:

Additional call options assigned to a ring group

To play music to ring group callers set this field to 'm($CLASS)', where m = MOH class e.g. m('default'). Please check details on the bottom

 [a-z]

Last Destination:

Last destination to be dialed if none of the ring group extensions answers the call

John dials Ring group 1000, but nobody answered his call. Sound file selected under 'Announce' is played to John and his call is be transferred to extension number set here.

 [0-9]

Record Calls:

Enable call recording service

Select 'Yes' to enable the service. All incoming/outgoing calls will be recorded. If using call recording with many extensions, check server disk space from time to time. Please see below for bit rates table.

 Options buttons

Silent:

Set weather call recordings should be announced to parties in conversation.

If Silent=No, calling parties will hear 'Recorded' or 'This call is recorded' message before their conversation starts

 Options buttons

Exit Digit:

Exit digit that transfers the call to 'Exit Destination'

John dials ring group 1000. While all extensions are ringing John presses 'Exit digit' set here (e.g. 9) and his call is transferred to 'Exit Destination'.

 [0-9]

Exit Extension:

PBXware extension to which the call is transferred once user dials the 'Exit Digit'

John dials ring group 1000. While all extensions are ringing John presses the 'Exit Digit' and his call is transferred to 'Exit Destination' provided here (e.g. 2001)

 [0-9]


Disk Space Used By Call Recording

With continuously tone 60 seconds

  • wav49 = 84.5kb

  • wav = 833.0kb

  • gsm = 85.0kb

With continuously silent tone (without sound) 60 seconds

  • wav49 = 84.0kb

  • wav = 827.0kb

  • gsm = 84.0kb

Dial Options:

  • t - Allow the called user to transfer the call by hitting #

  • T - Allow the calling user to transfer the call by hitting #

  • r - Generate a ringing tone for the calling party, passing no audio from the called channel(s) until one answers. Use with care and don't insert this by default into all your dial statements as you are killing call progress information for the user. Really, you almost certainly do not want to use this. Asterisk will generate ring tones automatically where it is appropriate to do so. 'r' makes it go the next step and additionally generate ring tones where it is probably not appropriate to do so.

  • R - Indicate ringing to the calling party when the called party indicates ringing, pass no audio until answered. This is available only if you are using kapejod's bristuff.

  • m - Provide Music on Hold to the calling party until the called channel answers. This is mutually exclusive with option 'r', obviously. Use m(class) to specify a class for the music on hold.

  • o - Restore the Asterisk v1.0 Caller ID behaviour (send the original caller's ID) in Asterisk v1.2 (default: send this extension's number)

  • j - Asterisk 1.2 and later: Jump to priority n+101 if all of the requested channels were busy (just like behaviour in Asterisk 1.0.x)

  • M(x) - Executes the macro (x) upon connect of the call (i.e. when the called party answers)

  • h - Allow the callee to hang up by dialing *

  • H - Allow the caller to hang up by dialing *

  • C - Reset the CDR (Call Detail Record) for this call. This is like using the NoCDR command

  • P(x) - Use the Privacy Manager, using x as the database (x is optional)

  • g - When the called party hangs up, exit to execute more commands in the current context.

  • G(context^exten^pri) - If the call is answered, transfer both parties to the specified priority; however it seems the calling party is transferred to priority x, and the called party to priority x+1

  • A(x) - Play an announcement (x.gsm) to the called party.

  • S(n) - Hangup the call n seconds AFTER called party picks up.

  • d: - This flag trumps the 'H' flag and intercepts any dtmf while waiting for the call to be answered and returns that value on the spot. This allows you to dial a 1-digit exit extension while waiting for the call to be answered - see also RetryDial

  • D(digits) - After the called party answers, send digits as a DTMF stream, then connect the call to the originating channel.

  • L(x[:y][:z]) - Limit the call to 'x' ms, warning when 'y' ms are left, repeated every 'z' ms) Only 'x' is required, 'y' and 'z' are optional. The following special variables are optional for limit calls: (pasted from app_dial.c)

    • + LIMIT_PLAYAUDIO_CALLER - yes|no (default yes) - Play sounds to the caller.

    • + LIMIT_PLAYAUDIO_CALLEE - yes|no - Play sounds to the callee.

    • + LIMIT_TIMEOUT_FILE - File to play when time is up.

    • + LIMIT_CONNECT_FILE - File to play when call begins.

    • + LIMIT_WARNING_FILE - File to play as warning if 'y' is defined. If LIMIT_WARNING_FILE is not defined, then the default behaviour is to announce ('You have [XX minutes] YY seconds').

  • f - forces callerid to be set as the extension of the line making/redirecting the outgoing call. For example, some PSTNs don't allow callerids from other extensions than the ones that are assigned to you.

  • w - Allow the called user to start recording after pressing *1 or what defined in features.conf, requires Set(DYNAMIC_FEATURES=automon)

  • W - Allow the calling user to start recording after pressing *1 or what defined in features.conf, requires Set(DYNAMIC_FEATURES=automon)