Skip to end of metadata
Go to start of metadata

This Article explains how to enable Callback feature for Call groups.

Available from WMS Version 3.88.42218.38

Created: September 2018


Dialplan configuration

This feature allows customers to request a callback instead of waiting for operators' response in case they are busy on the phone.

To implement this functionality, you need to configure 6 Dialplan procedures. 

Note: For convenience, you can easily import all 6 Dialplan procedures from the attached file (WMS Dialplan -> Dialplan rules -> click Import and upload the file).


Procedure 1: cgCbRequestCallback

The procedure is used to exit a queue and go to IVR confirmation:

Procedure 2: cgCbConfirm

The procedure confirms a phone number/ entering another number/ returning to the queue/ etc: 


0 - the number to return to the queue at the same position as the caller before pressing 1.

To return to the queue with the music on hold, use the following custom application:


Where "class2" is the name of the MoH class.

To return to the queue without music on hold, use the following custom application variant:


1 - the number to create a new call instead of the current one.

To execute Originate(), you need to set the following channel variables:

ORIGINATE_CHANNELLocal/${CALLERID(num)}@cgCbIn/ncgCbIn is the name of Procedure 5
ORIGINATE_CONTEXTcgCbOutcgCbOut is the name of Procedure 6
ORIGINATE_EXTEN${CALLERID(num)}The number to callback
ORIGINATE_CALLERIDCallback: ${CALLERID(name)} <${CALLERID(num)}>Setting the caller's number and name
ORIGINATE_TIMEOUT3600Waiting time (in seconds) for an operator's response before timeout. In the example - 1 hour
ORIGINATE_ASYNCtrueEnabling asynchronous mode. If it's "true" - Dialplan will continue execution without waiting for an operator's response
ORIGINATE_VARIABLESQUEUENAME=${QUEUENAME},QUEUEPOSITION=${QUEUEPOSITION}Setting in a new channel variables that we need further

and execute Custom application -> Originate(). After that, playback "Thank you for requesting a callback. You may now hang up and wait for our call. Goodbye".

2 - the number for entering a different callback phone.

- the number for repeating the message.

default - the number for checking the original Caller ID. If the number is valid, then the system offers a customer to order a call to this number, or enter another:

"Press 1, have an agent call you back to the phone number <say-as interpret-as='telephone'>${CALLERID(num)}</say-as>. Press 2, to enter a different callback number. Press 3, to listen again. Press 0 to return to the queue on hold".

$[! ${REGEX("^[+0-9][0-9]{6,14}$" ${CALLERID(num)})}]

Procedure 3: cgCbEnteringPhone

The procedure is used to enter another phone number:


9 - the number to return to the queue at the same position as the caller before pressing 9.

[0-8].  - the number to verify the input. If the entered number does not start from zero, the second digit is not zero and its length is not 7-15, then playback "The number you entered: <say-as interpret-as='telephone'>${ENTERED_NUMBER}</say-as> is incorrect"  and go to the default number. Otherwise, go to Dialplan procedure "cgCbValidatePhone":

$[ ${REGEX("^0[1-9][0-9]{5,13}$" ${ENTERED_NUMBER})}]

- play message "Please enter the phone number. Otherwise you may press 9 to return to the queue on hold" and wait for the response.

Procedure 4: cgCbValidatePhone

The procedure checks the callback number:


- the number to return to the queue at the same position as the caller before pressing 0.

- the number to confirm phone number.

- the number to re-enter phone number.

- the number to repeat the message.

i, t - numbers for processing timeout and invalid input.

default - the number to playback the client's phone number which he entered: "You have entered the following phone number: <say-as interpret-as='telephone'>${ENTERED_NUMBER}</say-as>", "Press 1 to confirm. Press 2 to try again. Press 3 to listen again. Press 0 to return to the queue on hold".

Procedure 5: cgCbIn

The procedure is used for adding a callback to the queue for the same position:



Procedure 6: cgCbOut

The procedure is executed when an operator answers a call. It is used for making outgoing call to customers and handling error/ notifications:

Setting the variable "PRESERVE_CID" allows you to save the Caller ID name of the original call.

In case of using non-English language, need to manually set the desired language using the Set application at the begining of the procedure.

Enable Callback for Call groups

To enable the callback for Call groups, in the queue settings in the dialplan parameter,

  • Go to WMS Dialplan -> Call Groups
  • Select the Call group and click Edit strategy
  • Change Dialplan procedure for the Group -> Select cgCbRequestCallback (Procedure 1):

Note: To notify customers about the callback possibility, you have to playback the callback announcement before entering the Call group.

Note: The possibility to enable periodic announcements is coming in the next versions.

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