Synopsis
Queue a call for a call queueDescription
Asterisk 1.6.0:Queue(queuename[,options[,URL[,announceoverride[,timeout[,AGI[,macro[,gosub[,rule]]]]]]]])Asterisk 1.4:
Queue(queuename[|options][|URL][|announceoverride][|timeout][|AGI])Asterisk 1.0 through 1.2:
Queue(queuename[|options][|URL][|announceoverride][|timeout])Queues an incoming call in a particular call queue as defined in queues.conf or dynamic realtime.
The option string may contain zero or more of the following characters:
- d — data-quality (modem) call (minimum delay).
- h — allow callee to hang up by pressing *.
- H — allow caller to hang up by pressing *.
- n — no retries on the timeout; will exit this application and go to the next step.
- r — ring instead of playing MOH.
- R — stops moh and rings once an agent is ringing (Asterisk Trunk)
- t — allow the called user to transfer the calling user.
- T — allow the calling user to transfer the call.
- w — allow the called user to write the conversation to disk via Monitor.
- W — allow the calling user to write the conversation to disk via Monitor.
- c — continue in the dialplan if the callee hangs up (Asterisk 1.6.0 and above).
- i — ignore call forward requests from queue members and do nothing when they are requested (Asterisk 1.6.0 and above).
- k — Allow the called party to enable parking of the call by sending the DTMF sequence defined for call parking in features.conf (Asterisk 1.6.0 and above).
- K — Allow the calling party to enable parking of the call by sending the DTMF sequence defined for call parking in features.conf (Asterisk 1.6.0 and above).
- x — allow the called user to write the conversation to disk via MixMonitor (Asterisk 1.6.0 and above).
- X — allow the calling user to write the conversation to disk via MixMonitor (Asterisk 1.6.0 and above).
In addition to transferring the call, a call may be parked and then picked up by another user.
'URL' allows you to specify a URL that will be sent to the called party if the channel supports it. You can also use an external application like QueueMetrics or Asteria Solutions Agent Client to launch the URL if your terminal does not support it.
- In Asterisk 1.4, the optional AGI parameter will setup an AGI script to be executed on the calling party's channel once they are connected to a queue member.
'announceoverride' allows you to override the announcement specified in queues.conf using 'announce = ...' or add one to it in the first place.
'timeout' sets the time in seconds that a call will wait in the queue before it is routed to the next priority in the dialplan. It defaults to 300 seconds (5 minutes).
Note: at least in asterisk 1.8.5 (and probably earlier) the default is for there to be no timeout, not a 300 second timeout.
The timeout will cause the queue to fail out after a specified number of seconds, checked between each queues.conf 'timeout' and 'retry' cycle. ...