Dial Groups
(Ring Groups)

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

Group Name: Dial group extension number (ex. Accounts)

Extension: Ring group extension number (ex. Once a user dials this number, all destinations assigned to the Dial group will ring (e.g. 1111))

Destinations: Extension Numbers assigned to a Dial group (ex. Once a Dial group number is dialed, all destinations set here will ring at the same time (e.g. 1001, 1002, 1003...))

Last Destination: Last destination to be called if none of the destination extensions answer the call (ex. 1010)

Edit the Dial group configuration (ex. Click to edit the ring group configuration)

Delete a ring group from the system (ex. Click to delete a Dial group from the system)

Add/Edit Dial Group

Clicking on the 'Add Dial Group' or 'Edit' button will open the following Dial group options:

Group Name: Unique Dial group name (ex.Set 'Accounts' here to create the same ring group)

Extension: Unique network number associated with the Dial group (ex. When this number is dialed, all extensions associated with it will ring at the same time)

Destinations: System extensions associated with the Dial group

Example: Provide an extension list separated by commas here (e.g. 1001,1002,1003...). When a Dial 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.

Incoming Limit (per call): If you have a scenario where call is sent from the current Dial group to the second one and the second one returns the same call back to first group, it will allow only this much loops.

Example: If this is set to 1 as it is by default, and the current Dial group sends the call to the next group (or any other object on the system), returning the same call from that object will not be permitted as same call can enter this group only once.

NOTICE: system wide limitation for these 'loops' is 10.

Advanced Options

These options fine-tune Dial group settings with additional options

Greeting: Greeting sound file played to callers when the Dial group is dialed

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

Answer on undefined greeting: If this option is turned on, the Dial group will not answer until the proper greeting is selected.

Timeout Message: Sound file played to caller if his call does not get answered by any of the Dial group extensions.

NOTE: Sound file must have 'announce-' name prefix (e.g. 'announce-unavailable') (ex. John dials Dial group 1000, but nobody answered his call. The sound file selected here will be played to John and then his call will be transferred to 'Last Destination' extension)

Loops: How many times to dial all extensions again if nobody answers (ex. John dials Dial group 1000, but nobody answers his call. If this option is set to '2', all extensions will be dialed one more time before transferring his call to 'Last Destination')

Timeout: How many seconds will all Dial group extensions ring before the call is considered unanswered (ex. This option is set to 20. John dials Dial 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')

Dial Options: Additional call options assigned to a Dial group (ex. To play music to Dial group callers, set this field to 'm($CLASS)', where m = MOH class e.g. m('default'). Please check details on the bottom)

Ring Strategy: This option regulates how extensions in the Dial Group will be rung.

Example:

      • All - ring all extensions in the group

      • Leastrecent - ring extension with least answered calls

      • Round - ring each available extension

      • Round Memory - like round, except we remember where we left off the last ring pass

Custom ringtone: Set a custom ringtone for the phones which are in this Dial group (ex. More info can be found in this section: Call Filters & Blocking)

Replace Caller ID: Replaces the caller ID with the custom data provided here. This is used when you want all incoming calls to your DialDial Group to have this value displayed as a caller ID information. Along with the custom data, you can use the '%CALLERID%' variable, which displays the calling party phone number.

NOTE: Please make sure you enter this information as it is written down, otherwise it will not work properly. (ex. Providing a 'USDID' here, will display 'USDID' on your phone display, for all calls coming to this Dial Group. Providing 'USDID %CALLERID%', will display 'USDID 55510205' on your phone display, where 55510205 is calling party phone number).

NOTE: If custom data from previous NOTE does not work for you, try with this variable 'USDID<%CALLERIDNUM%>'

Record Calls: Enable call recording service (ex. 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).

Silent: Set whether call recordings should be announced to parties in a conversation. (ex. If Silent=No, calling parties will hear a 'Recorded' or 'This call is recorded' message before their conversation starts)

Play Periodic Beep: To enable this feature, enter time in seconds to define how often periodic sound signal will be played to informed parties that call recording is enabled.

For example, enter 60 to enable this feature and play periodic signal every 60 seconds.

Exit Digit: Exit digits that transfers the call to the 'Exit Destination' (ex. John dials Dial group 1000. While all extensions are ringing, John presses the 'Exit digit' set here (e.g. 9) and his call is transferred to the 'Exit Destination').

Exit Extension: CloudPBX MT extension to which the call is transferred once the user dials the 'Exit Digit' (ex. John dials Dial group 1000. While all extensions are ringing, John presses the 'Exit Digit' and his call is transferred to the 'Exit Destination' provided here (e.g. 2001))

Last Destination: Last destination to be dialed if none of the Dial group extensions answer the call (ex. John dials Dial group 1000, but nobody answers his call. Sound file selected under 'Announce' is played to John and his call is transferred to the extension number set here).

Last Destination is voicemail: Choose whether you want calls to be redirected to the Last Destination or Last Destination voicemail

Confirm Calls: Chose whether the called number in the Dial group list should be asked to accept or refuse the call from Dial group.

Confirmation Message: Chose whether to play system default or some custom added sound asking if you want to answer or reject the call (ex. All sound files for this option should start with 'rg-announce')

Call Answered Message: Chose whether to play system default or custom sound file which is presented to user when he accepts the call from Dial group, but the call has already been answered by someone else (ex. All sound files for this option should start with 'rg-late-announce')

Disk Space Used By Call Recording:

With continuous tone for 60 seconds

      • wav49 = 84.5kb

      • wav = 833.0kb

      • gsm = 85.0kb

With continuous silent tone (without sound) for 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) - Hang up the call n seconds AFTER the 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 the call begins.

    • + LIMIT_WARNING_FILE - File to play as a warning if 'y' is defined. If LIMIT_WARNING_FILE is not defined, then the default behavior 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)