Automatic Call Distribution (ACD) or call queuing provides a way for a PBX to queue incoming calls. A queue is a “stack” or “line” of calls that need to be answered. When a call is directed into the queue, by default, the calls are answered in a first-in, first-out order. Call queues are useful when you have more callers than people available to answer calls. Callers placed into a queue will hear music or advertising until someone is available to answer their call. The Queues module allows you to create and design queues that allow callers to speak with agents as quickly and painlessly as possible.
Queues Consist of:
Queue Agent Login Toggle (All Queues)
Queue Agent Login Toggle (Single Queue)
Queue Agent Login Toggle (All Queues with Hint)
Queue Agent Login Toggle (Single Queue with Hint)
Click the Add Queue button.
Use this number to dial into the queue or transfer callers to this number to put them into the queue. This number can also be used in conjunction with feature codes related to agent login/logoff and BLF monitoring.
Give the queue a brief name to help you identify it.
Optional: You can require agents to enter a password before they can login to this queue. The password is only used when logging in with the legacy queue * code. When using the toggle codes, you must use the “Restrict Dynamic Agents” option in conjunction with the dynamic members list to control access.
This option has been removed. It is ALWAYS enabled
Individual hints and dialplan are generated for each SIP/PJSIP/IAX2 device that could be part of this queue. These hints are used in conjunction with programmable BLF phone buttons to log into and out of a queue and generate BLF status as to the current state. The format of the hints is *45ddd*qqq where *45 is the currently defined toggle feature code, ddd is the device number (typically the same as the extension number) and qqq is this queue's number.
If set to yes, queue calls to external phone numbers are forced into call confirmation mode. This includes queue calls to agents who are using external numbers, as well as to internal extensions whose call forwarding or follow-me settings are causing calls to route to external numbers. If call confirmation is enabled, the member must accept the call before it is answered and delivered.
Announcement played to the queue member announcing the queue call and requesting confirmation prior to answering. If set to default, the standard call confirmation default message will be played unless the member is reached through a Follow-Me that has an alternate message set. This message will override any other message specified. You can add additional recordings in the System Recordings module.
Optional: You can prefix the caller ID name of callers to the queue. ie: If you prefix with “Sales:,” a call from John Doe would display as “Sales:John doe” on the extensions that ring.
When set to Yes, the CID name will be prefixed with the total wait time in the queue so the answering agent is aware how long the caller has been waiting. It will be rounded to the nearest minute, in the form of “Mnn:” where “nn” is the number of minutes. If the call is subsequently transferred, the wait time will reflect the time since it first entered the queue or reset if the call is transferred to another queue with this feature set.
Optional: This can be used for distinctive ring with SIP devices.
If set to Yes, only the dynamic members listed in the Queue Agents tab will be able to log in. No one else would be allowed to log in as a dynamic member.
If this is set to Yes, and multiple agents are available, the PBX will send one call to each waiting agent (depending on the ring strategy). Otherwise, it will hold all calls while it tries to find an agent for the top call in the queue, making the other callers wait.
WARNING: When using a setting that sets the “ringinuse=no” flag, there is a NEGATIVE side effect. An agent who transfers a queue call will remain unavailable to any queue until that call is terminated, as the call still appears as “inuse” to the queue UNLESS “Agent Restrictions” is set to “Extensions Only.”
Gives queues a “weight” (priority level). The higher the weight, the higher the priority. (Default = 0) If there are agents common to multiple queues, the queue with the highest priority will deliver its calls first.
The Music on Hold (MoH) played to the caller while they wait in line for an available agent. Select an option from the drop-down menu. Choose “inherit” if you want the MoH class to be what is currently selected, such as by the inbound route.
Below the drop-down menu, select one of these three options:
The announcement played to callers before they join the queue. This can be skipped if there are agents ready to answer a call (meaning they still may be wrapping up from a previous call) or when they are free to answer the call right now. You can add additional recordings in the System Recordings module.
Force/Yes/Don't Care/No/Never: Set whether to record incoming calls to this queue. See the Call Recording Walk Through in the Tips & Tricks section of our wiki for more information.
If set to Yes, all calls are marked as "answered elsewhere" when cancelled. The effect is that missed queue calls are *not* shown on the phone as missed calls (if the phone supports it).
Important: Set a failover destination here by choosing a valid destination from the drop-down menus. The caller would be sent to this destination if they exit the queue for reasons such as maximum wait time, queue capacity, or join empty/leave empty settings discussed later in this wiki.
Static agents are extensions that are assumed to always be in the queue. Static agents do not need to “log in” to the queue, and cannot “log out” of the queue.
List extensions to ring, one per line. You can include an extension on a remote system or an external number (outbound routing must contain a valid route for external numbers). You can use the Agent Quick Select menu to quickly find and add extensions.
You can put a comma (,) after the agent followed by a penalty value to set an agent penalty. It will default to zero.
An advanced mode has been added which allows you to prefix an agent number with S, P, X, Z, D, or A. This will force the agent number to be dialed as an Asterisk device of type SIP, PJSIP, IAX2, ZAP, DAHDI, or Agent, respectively. This mode is for advanced users and can cause known issues in the PBX as you are bypassing the normal dialplan. If your “Agent Restrictions” are not set to “Extension Only,” you will have problems with subsequent transfers to voicemail. Other issues may also exist.
Dynamic agents are extensions or telephone numbers that can log in and out of the queue. Extensions included here will NOT automatically be logged in to the queue.
Defines the maximum number of seconds a caller can wait in a queue before being pulled out. (Default = unlimited) Choose the max wait time from the drop down menu.
Set the PBX timeout priority.
The number of seconds an agent’s phone can ring before we consider it a timeout. Unlimited or other timeout values may still be limited by system ring time or individual extension defaults.
If set to Yes, then the timeout for an agent to answer is reset if a BUSY or CONGESTION is received. This can be useful if agents are able to cancel a call with reject or similar.
The number of seconds to wait before trying all the phones again. Choosing No Retry will exit the queue and go to the failover destination as soon as the first attempted agent times-out. Additional agents will not be attempted.
This is how many seconds to wait after a successful call before sending another call to a potentially free agent (default is 0, or no delay). If using Asterisk 1.6+, you can also set the “Honor Wrapup Time” across queues on the Advanced Settings page so that this is honored across queues for members logged on to multiple queues.
If you wish to have a delay before the member is connected to the caller, or before the member hears any announcement message), set this to the number of seconds to delay.
Announcement played to the agent prior to bridging in the caller.
Examples: “The following call is from the Sales Queue” or “This call is from the Technical Support Queue.”
To add additional recordings, please use the System Recordings module. Compound recordings composed of 2 or more sound files are not displayed as options since this feature cannot accept such recordings.
If set to Yes, the caller's hold time will be reported to the agent before the caller is connected to the agent.
Whether to auto pause an agent in this queue (or all queues they are a member of) if they don't answer a call. Specific behavior can be modified by the Auto Pause Delay as well as Auto Pause Busy/Unavailable settings if supported on this version of Asterisk. Options are Yes in this queue only, Yes in all queues, and No.
If set to Yes, agents will be auto paused immediately (or after the auto pause delay set) if their devices report busy upon a queue call attempt.
If set to Yes, agents will be auto paused immediately (or after the auto pause delay set) if their devices report congestion upon a queue call attempt.
This setting will delay the auto pause of an agent by a certain number of seconds after taking a call. For example, if this were set to 120 seconds, and a new call is presented to the agent 90 seconds after they last took a call, the agent will not be auto paused if they don't answer the call. If the agent is presented with a call 120 seconds or later after answering the last call, and they do not answer, they will then be auto paused. If they have taken no calls, this will have no effect.
Define the maximum number of callers who can be waiting in the queue at the same time (0 for unlimited). If not set to 0, and the maximum capacity is reached, additional calls would be sent to the failover destination set in the General Settings tab.
Determines if new callers will be admitted to the queue. If not, the fail over destination will be immediately pursued. The options include:
Determines if callers should be exited prematurely from the queue in situations where it appears no one is currently available to take the call. The options include:
Asterisk: penaltymemberslimit. A limit can be set to disregard penalty settings, allowing all members to be tried, when the queue has too few members. No penalty will be weighed in if there are only X or fewer queue members.
Define how often to announce queue position and estimated holdtime (0 to disable announcements).
If set to Yes, the system will announce the caller's position in the queue to the caller. For example, "You are number three..."
Yes/No/Once: Whether the system will include the estimated hold time in position announcements. Hold time will not be announced if less than one minute.
You can optionally present an existing IVR as a “Break Out” menu. This IVR must only contain single-digit “dialed options.” The recording set for the IVR will be played at intervals specified in “Repeat Frequency” below. The announcement for the selected IVR must be system recording comprised of a single sound file. IVRs that have announcements composed of compount recording files will not be presented as selections for this field.
How often to announce a voice menu to the caller (0 to disable announcements).
Used for service level statistics (calls answered within service level time frame).
WARNING: Make sure you understand what you are doing, or otherwise leave this blank!
Provides an optional regex expression that will be applied against the agent callback number. If the callback number does not pass the regex filter, it will be treated as invalid. This can be used to restrict agents to extensions within a range, to prevent callbacks from including keys like *, or for any other use that may be appropriate.
This would restrict agents to extensions 2000-4999.
This would allow any number of any length, but restrict the * key.
Whether to enable queue statistics reset.
If you have the commercial VQ Plus module, a Queue Plus Options tab will be available. Please see the VQ Plus user guide for information on these options.
Check this box in order to make this queue available in iSymphony, which is a cross-platform solution for managing and using your phone system.
When finished, click the Submit button, then click the Apply Config button.
Other Modules such as QXact Reports, Xactview or iSymphony may hook in to the queues module and have their own options. These modules will vary by install and use case and are covered under the umbrella of their own documentation.
You may edit/delete queues by clicking the desired queue in the right side navigation menu.