B.88. Queue()

Places a call in the specified queue.
Queue(queue[,options[,URL[,announcement[,timeout[,AGI]]]]])
Passes an incoming call into the specified queue (predefined in queues.conf).
The following options are available and may be combined:
t
Allow the called party to transfer the call.
T
Allow the calling party to transfer the call.
d
Data-quality (modem) call (minimizes delay).
h
Called party may end the call by pressing "*".
H
Calling party may end the call by pressing "*".
n
No retries on timeout; proceeds to the next priority.
r
Rings instead of playing music-on-hold.
i
Ignore call forward requests from queue members; instead do nothing.
w
Allow the called party to record the conversation via Monitor().
W
Allow the calling party to record the conversation via Monitor().
If a call is transferable, it may also be parked and retrieved by another user.
The argument announcement specifies a wait announcement to be played back to the caller at intervals until a queue member answers the call; the default announcement, if there is one, is defined in queues.conf.
The optional URL is sent to the caller if the the calling channel supports it. This could be used on compatible SIP phones to provide queue information to the phone's display panel.
The timeout argument causes the call to fail out of the queue after timeout number of seconds. The default is 300 seconds (or 5 minutes).
Returns -1 if the originating channel is hung up or if the call is connected to a queue member and ended by one of the parties. If the queue is full, does not exist, or has no member, returns 0; execution continues in the next priority in the dialplan.
; pass the caller to the support queue:
exten => 123,1,Answer()
exten => 123,n,Queue(support,t)

Note

Internal help for this application in Asterisk 1.4:
  -= Info about application 'Queue' =- 

[Synopsis]
Queue a call for a call queue

[Description]
  Queue(queuename[|options[|URL][|announceoverride][|timeout][|AGI]):
Queues an incoming call in a particular call queue as defined in queues.conf.
This application will return to the dialplan if the queue does not exist, or
any of the join options cause the caller to not enter the queue.
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 hitting *.
      'H' -- allow caller to hang up by hitting *.
      'n' -- no retries on the timeout; will exit this application and 
             go to the next step.
      'i' -- ignore call forward requests from queue members and do nothing
             when they are requested.
      'r' -- ring instead of playing MOH
      't' -- allow the called user transfer the calling user
      'T' -- to 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
  In addition to transferring the call, a call may be parked and then picked
up by another user.
  The optional URL will be sent to the called party if the channel supports
it.
  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.
  The timeout will cause the queue to fail out after a specified number of
seconds, checked between each queues.conf 'timeout' and 'retry' cycle.
  This application sets the following channel variable upon completion:
      QUEUESTATUS    The status of the call as a text string, one of
             TIMEOUT | FULL | JOINEMPTY | LEAVEEMPTY | JOINUNAVAIL | LEAVEUNAVAIL
diff output to internal help in Asterisk 1.2:
8c8
<   Queue(queuename[|options[|URL][|announceoverride][|timeout][|AGI]):
---
>   Queue(queuename[|options[|URL][|announceoverride][|timeout]]):
17,19c17
<              go to the next step.
<       'i' -- ignore call forward requests from queue members and do nothing
<              when they are requested.
---
>        go to the next step.
29,30d26
<   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.