Skip to end of metadata
Go to start of metadata

Mar 25, 2018 05:04

Call distribution in Call groups - English

This Guide explains how to edit the strategy of call distribution in Call groups and provides the information on dynamic login to Call groups via Collaboration.

Updated: March 2018

WMS Version: 3.88

Online version:

Call distribution in Call groups

For the basic information about Call groups (how to create a Call group, route incoming calls etc.), see the WMS Start GuideRoute incoming calls to call agents section.

Note: it is possible to add called numbers present in Dialplan procedures to Call groups.
Example: add the number 112233@test to the Call group, where “test” is the name of the existing Dialplan procedure, “112233” is the called number present in this Dialplan procedure. This ability can be useful for special configurations, for example, you can configure the Dialplan “test” to playback a special message to the caller.

  • Go to WMS -> Dialplan -> Call Groups
  • Select the group and click Edit strategy:


1 - Timeout: the maximum period of time in seconds, during which the system tries to connect the caller to a Call group member; after the timeout is reached, timeout set up in Seconds before calling all the members again field is applied; after which system will try to connect the caller to a Call group member again

Timeout set up in Dialplan application “Call group” = 40 seconds
Timeout set up for the Call group in Edit stategy -> Timeout = 15 seconds
Timeout set up in Edit strategy -> Seconds before calling all the members again = 5 seconds
System tries to connect the caller for 15 seconds, after 5 seconds of silence, system tries again to connect the caller for 15 seconds, after 5 seconds of silence the Dialplan execution proceeds to the next step, since the timeout set up in the Dialplan (40 seconds) has been reached.

2 - Announce frequency: enable notification of the position in the queue to the caller

3 - Announce hold time: if enabled, other than notification of position in the queue, notifies the caller of the estimated time limit before the response

Note: additionally, to enable Announce frequency and Announce hold time options, select Music on hold class in the Dialplan used for managing calls of the Call group. For this purpose you can configure a special directory in Sounds menu of WMS: go to MusicOnHold folder, click + Directory to add a new directory and upload audio files:

Starting from WMS 3.88, it is also possible to play random music on hold. To enable the option, go to WMS -> Settings -> PBX -> SIP-RTP add check off "Random music on hold".

4 - Priority: if you have two call groups with differing priorities (e.g., support and support-vip), agents present in both call groups receive the calls from the higher-priority queue comparing to calls from the lower-priority queue. Those agents will not receive any calls from the lower-priority queue unless there are no more calls in the higher-priority queue. (Normally, there will be some agents who are present only in the lower-priority call group, to make sure that those calls are also answered in a timely manner)

5 - Seconds before calling all the members again: enter the number of seconds

6 - Wrap up time: set up the timeout between the calls for one operator. The operator does not receive calls for the period of this timeout. 

7 - Auto pause on no answer: if enabled, a Call group member is automatically paused for the duration period of Wrap up time (no, only this queue, for all queues):

  • no: default Call group behavior. Call group members are not autopaused
  • only this queue: a Call group member is autopaused for the wrap up time only in the Call group in which this member didn't answer a call

    Note: There is one known issue with Only this queue option:

    In case a Call group member belongs to several call groups and he/ she has enabled Unavailable on away/ dnd in Collaboration ->  Settings ->   Contact center, the member's status is changed to Away in all call groups he/ she belongs to. If Unavailable on away/ dnd is disabled, a Call group member will be auto paused only in a call group where he/ she didn't answer a call.

  • for all queuesa Call group member is autopaused for the wrap up time in all Call groups in case this member didn't answer a call in one Call group


  • Queues with Call all 32 strategy do not support this feature!
  • If Auto pause on no answer is enabled in WMS -> Dialplan -> Call Groups -> Edit strategy, it is necessary to specify Wrap up time

Important: Wrap up time must be different from 0!

 - Auto pause delay: delay in seconds before auto-pausing in case a Call group member did not answer a queue call after the last call was answered. 
For example, Auto pause delay is set to 3 minutes and a Call group member receives a new call after 2 minutes. In case a Call group member doesn't answer the call, he/ she will not be auto-paused. If the next call is received within 3 minutes or more after answering the last one, a Call group member will be auto paused.

9 - Max length: maximum number of calls in queue, when the number is exceeded, other calls are not put to the queue but are routed according to the next step of the Dialplan

10 - Dialplan: you can specify the Diaplan procedure here, allowing the caller to leave the queue by pressing a digit (a corresponding match must be present in this Dialplan procedure as "Called number") for further actions. For example, add Diaplan procedure with Called Number "1" and application "Dial the phone". The caller can leave the queue by pressing 1 and that call will be forwarded to the number specified in the application "Dial the phone".

11 - Strategy: set up the way the calls are distributed to the members of the Call group (Call AllRound RobinLongest IdleFewest CallsLinear)

Note: those Call group members who has enabled "Call waiting" option, can receive more than one call at a time. In case this behaviour is not preferred, disable the option in WMS -> Users -> Edit preferences and check off "Call waiting" or in Collaboration -> Settings -> Features.

  • Call All 10: agents are called by groups of 10 (10+10+10+X) until one answers
    • dynamically added users in this case receive the call together with the first 10 members
    • Timeout specified in the first field is applied to each group of members

You have a group of 16 agents, Timeout = 30 seconds: the system tries to dial the first 10 agents for 30 seconds, then the remaining 6 agents for 30 seconds.

Note: in this case, if the Timeout set up in Dialplan application is less than 30 seconds, the second group of agents will never receive an incoming call.

  • Call All 32: all available agents OR devices are called simultaneously until one answers (iOS / Android / Web devices are not supported)
  • Round Robin: the next agent is selected on the list following the individual that received the last incoming call
  • Longest Idle: the agent who answered the call the longest time ago is called
  • Fewest Calls: call the agent who has the lowest number of answered calls
  • Linear: agents are called sequentially starting from the first member on the list until an earlier person is no longer on the phone
    • dynamically added users are called in the order in which they are added

Add agents to call groups

Limitation on the number of Call group members

The maximum number of Call group members depends on the license type (Per Service/ Per User) and the amount of concurrent calls it offers + 2 additional call group members. The number of concurrent calls can be checked  in WMS -> Settings -> Tools and utilities -> Activation / Licenses. Example: the PBX supports 15 concurrent calls, this means you can add up to 17 static call group members.

Read more about the licensing: PBX Licensing and Activation Admin Guide.

Limitation for PBXs with Per Service licences: 

WGW250 – no limit
WGW90 – 32 members
WGW40 – 17 members
WGW16 – 10 members
WGW12 – 8 members
WGW8 – 6 members

Example: WGW40 Activation license offers 15 concurrent calls. The max number of Сall group members is 17 (with 2 additional calls).

Limitation for PBXs with Per User licenses:

Example: according to the licences, the number of concurrent calls is 422. This means that the maximum number of Call group members is 424:

Note: limitation does not apply for dynamically added call group members (see the chapter below).

Dynamically added call group members

Users can be dynamically added to Call groups via:

These members are not displayed in WMS -> Dialplan -> Call Groups, but they are displayed via WebAPI interface.

These members do not disappear from the Call group after PBX restart; they can be removed in the same way they had been added (by Feature Code, via WebAPI or Contact center).

Contact center in Collaboration

Starting from WMS version 3.87, users can dynamically log into Call groups from Collaboration:

  • Go to Collaboration Settings -> Contact center (or WMS -> Users -> Edit preferences -> Settings -> Contact center)
  • Check the groups you would like to answer for (status in call groups where you are statically added as a member via WMS cannot be changed on this page)

  • Enable Sign-on option

  • Click Save

Enable the option Unavailable on away / dnd if you would like:

  • to be auto-paused in all call groups when changing user status to "Away/ DND" 
  • In addition, if you also enable Auto pause on no answer in WMS -> Dialplan -> Call Groups -> Edit strategy, your status will be changed to Away in case of no answer within the timeout (specified in WMS -> Dialplan -> Call Groups -> Edit strategy -> Timeout or Dialplan application "Call group" -> Timeout) for the duration period of Wrap up time


In WMS -> Dialplan -> Call Groups -> Edit strategy, the following parameters are set:

  • Timeout is set to 5 seconds 
  • Wrap up time is set to 10 seconds 

  • Auto pause on no answer is set to only this queue

Unavailable on away / dnd is enabled in Collaboration Settings -> Contact center:

In this case if you don’t answer a call within 5 seconds timeout (Timeout set on Call group) you are put on pause in the current queue for the duration period of 10 seconds (Wrap up time set on Call group) and your user status changes to Away with expiration period of 10 seconds (because Unavailable on away / dnd is enabled and Wrap up time is set to 10). If Unavailable on away / dnd is disabled in Collaboration Settings -> Contact center, you are still put on pause in queue but your user status does not change to Away.


  • No sync between dynamic users added via WebAPI and via Contact Center (which means, users added via WebAPI cannot see that they are present in the group from Collaboration Contact center menu)

Call groups manager

First member of call group (even if added dynamically) becomes Call group manager and receives the missed call notification to email.
In case of using “call all” strategy, missed call is also assigned to the Call group manager.

Quality management

Call group manager can monitor over the service quality provided to callers by Call group members. This capability is available via Call Intrusion options: Listen / Barge / Whisper. Detailed information can be found in Call intrusion chapter of Collaboration User Guide. 

Note: the Call Intrusion capabilities are available only with appropriate ACL permissions "Can" - "Intrusion". Read more about ACL in this online documentation.

Additionally, Call group manager can monitor in real time the call activity using CDR-View (check CDR-View User Guide) or Call Center Wallboard (read the chapter "Wallboard" of Collaboration WebAPI Guide). 

Example of the Dialplan procedure for managing Call group calls

  • "Set" - "Ringtone" application adds a ringtone to distinguish the Call group calls from other calls of a Call group member

    Note: setting the rigtone is not available with "Call All 32" queue strategy.

  • "Play sound" application adds a welcome message which is played to callers prior to delivering them to an available agent
  • "Record call" application enables the recording of all calls managed by the Call group

    Note: recording can be also started by any agent after answering a call. Check Collaboration User Guide for additional information.

  • "Call group" application routes calls to the specified Call group

Note: detailed information on each described Dialplan application can be found in Dialplan applications Admin Guide.

Not finding the help you need?
Join the Facebook group to ask a question!

  • No labels