General

ERG Name: Unique ERG network name/identifier (ex. Provide a unique ERG identifier/name here)

ERG Number: Unique network ERG number (ex. This number is to be dialed in order to access the ERG)

Max Waiting Callers: Maximum number of callers allowed to wait in an ERG at the same time. This number should be set in accordance with the number of members answering the ERG calls (ex. If this field is set to 4, only 4 callers will be allowed to enter the ERG. If caller number 5 tries to enter the ERG he will be transferred to 'Redirect Extension' number).

Ring to Answer: How many rings will be played to a caller before call enters the ERG.

Set this value to 0 if you would like calls to hear ERG music on hold as soon as call is connected.

Record ERG Calls: Set whether to record ERG calls or not. NOTE: To record calls with ERG, this option has to be set to 'Yes'. There is no inheritance applied in this case.

Wake up Mobile Devices: Select whether ERG should wake up mobile devices that are asleep or not

Music On Hold: Select MOH(Music On Hold) class name. All sound files in this MOH class will be played to users in ERG. (E.g., User A enters the ERG. After the greeting message is heard, all sound files belonging to the selected MOH class are played in the background.)

Replace CallerID: Replace the caller id with the custom value. (E.g., Type 'Lobby - %CALLERID%' to display the caller id information as 'Lobby - 5552879' where 5552879 is the actual number calling in)

Language: Define the custom language for all sound files played by the ERG. 

ERG URL: Send the following URL to Member's softphone if it supports that option. The softphone can open that URL so the Member can see the caller's additional info if available. A softphone must support this option for it to be used.

Custom Ringtone: Set a custom ringtone for the phones which are in this Dial group.

Operation Times

Set the queues open/closed times. Depending on the time when call is received, the call can be redirected to different CloudPBX MT destinations

Operation Times: Enable operation times (ex. Yes, No, Inherit)

The Inherit option will allow administrators to simply put the Higher Level Operation Times settings back into effect if deemed necessary. Previously, when Operation Times were set, it could be either turned on or off, but it could not be reset to use the Operation Times rules set on the higher level (Server or Tenant).

Default Destination: CloudPBX MT extension all calls are redirected to during the closed time hours (ex. 1000)

Greeting: Greeting sound file played to callers during the closed times (ex. greeting-***)

Description of destinations follows in this priority order:

• • • Open dates: Sets the working hours during which DID is to redirect calls as set in DID Add/Edit window. If any call is received during the hours not set here, 'Custom Destination' are checked, and if they do not apply, the call is redirected to 'Default Destination' (Closed dates)

    • Custom Destinations: Redirects all calls received during set hours to the CloudPBX MT extension provided here

    • Closed dates: Sets the specific date when all calls are redirected to a 'Default Destination'. If 'Destination' field in the Closed dates is set, call will not go to 'Default Destination' but to this number.

Members

Members: This button opens up a screen in which you can add and manage ERG members (ex. Click on the button to manage ERG  members)

Static Members login: This option defines whether the Extensions set as Static Members have to log in in order to become an active Queue member.

Set this option to No for Extensions added as Static Members of the Queue to automatically become active Queue members without needing to log in.

Disable Member Enhanced Services: When this option is set to Yes, features in extensions enhanced services used by queue static members and callback agents, will be avoided when queue call is passed to them.

In case extension used by queue member have Call Forwarding enabled, this service will be overriden and call would be connected to the queue member instead forwarded to set number.

NOTE: Dynamic agents, as well as static members with Login feature set to Yes, will never have Enhanced Services rules applied to their calls, regardless of what option is selected for Disable Member Enhanced Services feature. This is expected behavior and cannot be altered.

Ring Strategy: Set the way calls are transferred to queue members answering the calls.

Available options:

• • • ringall - Ring all available Members until one answers (default)

    • linear - When used with static members, the linear ringing strategy will ring interfaces in the order specified in the queues.conf configuration file for that specific queue, always starting at the beginning of the list. If used with dynamic members, the members will be rung in the order in which they were logged in.

    • leastrecent - Rings the interface that least recently received a call. In a queue where there are many calls of roughly the same duration, this can work. It does not work as well if an agent has been on a call for an hour, and their colleagues all got their last calls 30 minutes ago, because the agent who just finished the 60-minute call will get the next one.

    • fewestcalls - Rings the interface that has completed the fewest calls in this queue. This can be unfair if calls are not always of the same duration. An agent could handle three calls of 15 minutes each and her colleague had four 5-second calls; the agent who handled three calls will get the next one.

    • random - Rings a random interface. This actually can work very well and end up being very fair in terms of evenly distributing calls among agents.

    • rrmemory - Round robin with memory. rrmemory should pick up at the last interface it was at when the last call came into the queue.

    • rrordered - Same as rrmemory, except the queue member order from the config file is preserved so interfaces will ring in the order specified in this configuration file. If you use dynamic members, the members will be rung in the order in which they were added.

    • wrandom - Rings a random interface, but uses the member's penalty as a weight when calculating their metric. So a member with a penalty of 0 will have a metric somewhere between 0 and 1000, and a member with a penalty of 1 will have a metric between 0 and 2000, and a member with a penalty of 2 will have a metric between 0 and 3000. Please note, if using this strategy, the member penalty is not the same as when using other queue strategies. It is ONLY used as a weight for calculating metric.

    • Autofill - Should callers be served one by one or in parallel fashion (ex. With this option turned 'Off', even if there are five agents available, calls will not be transferred to them until the first caller waiting in a queue is connected to an agent. When the first caller gets served, caller number two gets served and all others keep waiting. It is recommended to keep this feature always turned 'On' so callers can be served in order)

Member Ring Timeout (sec): Set the Member's ring timeout.

Autofill: Should callers be served one by one or in a parallel fashion. (E.g., With this option turned 'Off', even if there are five members available, calls will not be transferred to them until the first caller waiting in an ERG is connected to the member. When the first caller gets served, caller number two gets served, and all others keep waiting. It is recommended to keep this feature always turned 'On' so callers can be served in order)

Ring Members in Use: Set whether Members in use should be called when a new caller comes into the ERG. (E.g., If the Member is already in an active conversation, with this option set to 'Yes', the Member's Extension will ring when a new caller enters the ERG.)

Retry All Timeout: Time interval in seconds, for how long to wait before trying the queue agent again. (ex. If agent Smith cannot answer the incoming queue call and hangs up the ringing line, the call will not be transferred back to his extension for a time in seconds provided in this field).

Timeout Restart: If this option is set to yes and a BUSY or CONGESTION signal is received on the line, the agent's timeout for answering will be reset. This can be useful with agents that have permission to cancel a call with a reject. (ex. A call enters the queue and is transferred to Agent X. Agent X has a Polycom phone (for example) and sends a BUSY signal by hitting the 'Reject' key. This will reset the internal timer. The call will be transferred to other queue agent(s). The original agent will not be contacted until all other agents are tried and the call does not get answered by any of them).

Wrap-up Time: After a successful call, this will determine how long to wait (time interval in seconds) before sending a new call to a potentially free agent/member (ex. 4)

Enhanced Ring Group Full

Redirect Destination: ERG full redirect extension number. (E.g., If ERG 2000 accepts a maximum of 4 users waiting simultaneously, any new user that enters ERG 2000 will be redirected to the extension number provided here.)

Redirect to Voicemail: Choose whether the redirect extension is a voicemail.

Enhanced Ring Group Timers

Prioritize ERG Timeout: Set whether to prioritize ERG timeout or not.

Max Wait Seconds: The maximum time a caller can wait in an ERG. Once this time is exceeded caller will be redirected to the 'Max Wait Destination' number, or a callback will be activated. (E.g., User A is waiting 5 minutes already in the ERG. Suppose this field is set to 300(300s = 5min). In that case, A will be redirected to 'Max Wait Destination', or a callback will be activated depending on the configuration.)

Max Wait Destination: This option works along with the 'Max Wait Seconds' field. Drop down to select the extension to which the caller will be redirected once the time set under 'Max Wait Seconds' exceeds. (E.g., User A is waiting 5 minutes already in the ERG. If the 'Max Wait Seconds' field is set to 300(300s = 5min) and the Max Wait Destination option is selected, A will be redirected to this destination.)

Is Voicemail: Set whether the max wait destination is pointing to voicemail.

Enhanced Ring Group Empty

Leave when empty: When there are no members inside a queue, callers will leave it depending on the setting. (EG. No - This option is disabled Yes - If you wish to remove callers from the queue if there are no members present.)

Empty Destination: When queue doesn"t have any agent logged in, redirect callers to following destination. 

Is Voicemail: Set whether the empty destination extension is pointing to voicemail.

Greeting

Greeting: Select a greeting file that will be played to all callers waiting in this ERG. (E.g., queue-greeting-introduction)

Position Announcements

There are two types of position announcements: 'Hold Time' (Tells the ERG position) and 'Periodic Announcements' (Plays custom message).

Announce Hold-Time: Enable callers waiting in an ERG to hear the hold-time announcements. (E.g., Setting this option to 'Yes' will enable the hold-time announcements. A single caller waiting in an ERG would hear, 'The estimated hold time is currently N minutes. Thank you for your patience message).

Announce Position: Enable callers waiting in an ERG to hear the position announcements. (E.g., Setting this option to 'Yes' will enable the position announcements. A single caller waiting in an ERG would hear, 'Your call is now first in line and will be answered by the next available representative. Thank you for your patience message).

Announce Frequency: How often to play the hold-time announcement message (time in seconds). NOTE: If you set this option to '0', the announce message will not be played. (E.g., If this field is set to 30, a single caller waiting in an ERG will hear, 'Your call is now first in line and will be answered by the next available representative. Thank you for your patience.' message every 30 seconds) The estimated hold time is currently N minutes.

Min. Announce Frequency: Specify the minimum amount of time before we announce the caller’s position in an ERG again. This is used when the caller’s placement may frequently change to prevent the caller from hearing multiple updates in a short period. The default value is 15 seconds.

Announce Round Seconds: Rounding level for hold-time announcements. If this is set to 0, only minutes, not seconds, are announced; other possible values are 0, 5, 10, 15, 20, and 30. (E.g., When set to 30, a wait time of 2:34 will be rounded to 2:30.)

Periodic Announcements

Periodic Announce: Select the sound file that is played periodically to callers waiting in an ERG.

Periodic Announce Frequency: Time interval in seconds at which the periodic message will be played to the callers waiting in the ERG.

First Periodic Announce Delay: The minimum number of seconds between position announcements. Default value is 15 seconds. (E.g. 30) ([0-9])

Incoming Options

Incoming Options Set the advanced queue call options.

Available options:

• • • t - allow the called user to transfer the calling user

    • T - allow the calling user to transfer the call

    • H - allow the caller to hang up by hitting *

    • n - no retries on the timeout; will exit queues and go to the next step

    • r - ring instead of playing MOH

    • C - avoid missed calls in ringall strategy

    • Ring ('r') timeout

When 'r' is selected as Incoming Options and this timeout is used, queue will first ring entered number of seconds after which MOH will start (ex. 10)

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 of 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 behavior (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 called party 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 called party.

    • + 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 Caller IDs 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)

Exit Digit

Use Exit Digit: Should users be able to exit the queue by dialing a single digit and be automatically redirected to a preset CloudPBX destination.

Example: John enters the sales queue. A greeting message explains that the user may quit the queue by pressing the digit defined under the 'Exit Digit' option, and be transferred directly to the operator or some other destination (set under 'Extension' option).

Exit Digit: Define the exit digit here. Once this digit is dialed by the user waiting in queue, it will transfer the call directly to 'Extension' destination

Example: John enters the sales queue. The greeting message explains thatthe user may quit the queue by pressing the digit defined here (e.g. 9) and is transferred directly to the operator or some other destination (set under 'Extension' option).

Extension: Local CloudPBX extension number that is dialed once the 'Exit Digit' is dialed. (ex. John enters the sales queue. The greeting message explains that the user may quit the queue by pressing the digit defined under the 'Exit Digit' option, and be transferred directly to the CloudPBX extension defined here).

Is voicemail: Set whether the exit digit extension is pointing to voicemail.

Abandoned Calls Notification

Here you can set whether there will be any notification when the call inside an ERG is abandoned.

Enable Notification: Enable or disable the Abandoned Calls Notification feature.

Notification E-mail address: The e-mail address will receive notifications of abandoned calls. An abandoned call is one where the caller hangs up the call while waiting to be answered. (E.g., admin@domain.com)

Members Announcements

Member Announce: Select the pre-recorded message that will be played to the ERG member before the call is connected. NOTE: The sound file name must start with a ‘member-announce-' prefix to be displayed in the drop-down list.

Report Holdtime: Set this option to yes to inform the ERG member how long the caller was waiting in the queue before the call was connected.