<html>
<head>
<base href="https://wiki.asterisk.org/wiki">
<link rel="stylesheet" href="/wiki/s/en/2171/18/9/_/styles/combined.css?spaceKey=AST&forWysiwyg=true" type="text/css">
</head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
<h2><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+10+Application_Queue">Asterisk 10 Application_Queue</a></h2>
<h4>Page <b>added</b> by <a href="https://wiki.asterisk.org/wiki/display/~wikibot">Wiki Bot</a>
</h4>
<br/>
<div class="notificationGreySide">
<h1><a name="Asterisk10Application_Queue-Queue%28%29"></a>Queue()</h1>
<h3><a name="Asterisk10Application_Queue-Synopsis"></a>Synopsis</h3>
<p>Queue a call for a call queue.</p>
<h3><a name="Asterisk10Application_Queue-Description"></a>Description</h3>
<p>In addition to transferring the call, a call may be parked and then picked up by another user. </p>
<p>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. </p>
<p>This application does not automatically answer and should be preceeded by an application such as Answer(), Progress(), or Ringing(). </p>
<p>This application sets the following channel variable upon completion: </p>
<ul>
<li><tt>QUEUESTATUS</tt> - The status of the call as a text string.
<ul>
<li><tt>TIMEOUT</tt></li>
<li><tt>FULL</tt></li>
<li><tt>JOINEMPTY</tt></li>
<li><tt>LEAVEEMPTY</tt></li>
<li><tt>JOINUNAVAIL</tt></li>
<li><tt>LEAVEUNAVAIL</tt></li>
<li><tt>CONTINUE</tt></li>
</ul>
</li>
</ul>
<h3><a name="Asterisk10Application_Queue-Syntax"></a>Syntax</h3>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>Queue(queuename[,options[,URL[,announceoverride[,timeout[,AGI[,macro[,gosub[,rule[,position]]]]]]]]])</pre>
</div></div>
<h5><a name="Asterisk10Application_Queue-Arguments"></a>Arguments</h5>
<ul>
<li><tt>queuename</tt></li>
<li><tt>options</tt>
<ul>
<li><tt>C</tt> - Mark all calls as "answered elsewhere" when cancelled.</li>
<li><tt>c</tt> - Continue in the dialplan if the callee hangs up.</li>
<li><tt>d</tt> - data-quality (modem) call (minimum delay).</li>
<li><tt>h</tt> - Allow <b>callee</b> to hang up by pressing <tt>*</tt>.</li>
<li><tt>H</tt> - Allow <b>caller</b> to hang up by pressing <tt>*</tt>.</li>
<li><tt>n</tt> - No retries on the timeout; will exit this application and go to the next step.</li>
<li><tt>i</tt> - Ignore call forward requests from queue members and do nothing when they are requested.</li>
<li><tt>I</tt> - Asterisk will ignore any connected line update requests or any redirecting party update requests it may receive on this dial attempt.</li>
<li><tt>r</tt> - Ring instead of playing MOH. Periodic Announcements are still made, if applicable.</li>
<li><tt>R</tt> - Ring instead of playing MOH when a member channel is actually ringing.</li>
<li><tt>t</tt> - Allow the <b>called</b> user to transfer the calling user.</li>
<li><tt>T</tt> - Allow the <b>calling</b> user to transfer the call.</li>
<li><tt>w</tt> - Allow the <b>called</b> user to write the conversation to disk via Monitor.</li>
<li><tt>W</tt> - Allow the <b>calling</b> user to write the conversation to disk via Monitor.</li>
<li><tt>k</tt> - Allow the <b>called</b> party to enable parking of the call by sending the DTMF sequence defined for call parking in <tt>features.conf</tt>.</li>
<li><tt>K</tt> - Allow the <b>calling</b> party to enable parking of the call by sending the DTMF sequence defined for call parking in <tt>features.conf</tt>.</li>
<li><tt>x</tt> - Allow the <b>called</b> user to write the conversation to disk via MixMonitor.</li>
<li><tt>X</tt> - Allow the <b>calling</b> user to write the conversation to disk via MixMonitor.</li>
</ul>
</li>
<li><tt>URL</tt> - <em>URL</em> will be sent to the called party if the channel supports it.</li>
<li><tt>announceoverride</tt></li>
<li><tt>timeout</tt> - Will cause the queue to fail out after a specified number of seconds, checked between each <tt>queues.conf</tt> <em>timeout</em> and <em>retry</em> cycle.</li>
<li><tt>AGI</tt> - Will setup an AGI script to be executed on the calling party's channel once they are connected to a queue member.</li>
<li><tt>macro</tt> - Will run a macro on the calling party's channel once they are connected to a queue member.</li>
<li><tt>gosub</tt> - Will run a gosub on the calling party's channel once they are connected to a queue member.</li>
<li><tt>rule</tt> - Will cause the queue's defaultrule to be overridden by the rule specified.</li>
<li><tt>position</tt> - Attempt to enter the caller into the queue at the numerical position specified. <tt>1</tt> would attempt to enter the caller at the head of the queue, and <tt>3</tt> would attempt to place the caller third in the queue.</li>
</ul>
<h3><a name="Asterisk10Application_Queue-SeeAlso"></a>See Also</h3>
<p><a href="/wiki/display/AST/Asterisk+10+Application_Queue" title="Asterisk 10 Application_Queue">Asterisk 10 Application_Queue</a><br/>
<a href="/wiki/pages/createpage.action?spaceKey=AST&title=Asterisk+10+Application_QueueLog&linkCreation=true&fromPageId=19005740" class="createlink">Asterisk 10 Application_QueueLog</a><br/>
<a href="/wiki/pages/createpage.action?spaceKey=AST&title=Asterisk+10+Application_AddQueueMember&linkCreation=true&fromPageId=19005740" class="createlink">Asterisk 10 Application_AddQueueMember</a><br/>
<a href="/wiki/pages/createpage.action?spaceKey=AST&title=Asterisk+10+Application_RemoveQueueMember&linkCreation=true&fromPageId=19005740" class="createlink">Asterisk 10 Application_RemoveQueueMember</a><br/>
<a href="/wiki/pages/createpage.action?spaceKey=AST&title=Asterisk+10+Application_PauseQueueMember&linkCreation=true&fromPageId=19005740" class="createlink">Asterisk 10 Application_PauseQueueMember</a><br/>
<a href="/wiki/pages/createpage.action?spaceKey=AST&title=Asterisk+10+Application_UnpauseQueueMember&linkCreation=true&fromPageId=19005740" class="createlink">Asterisk 10 Application_UnpauseQueueMember</a><br/>
<a href="/wiki/pages/createpage.action?spaceKey=AST&title=Asterisk+10+Function_QUEUE_VARIABLES&linkCreation=true&fromPageId=19005740" class="createlink">Asterisk 10 Function_QUEUE_VARIABLES</a><br/>
<a href="/wiki/pages/createpage.action?spaceKey=AST&title=Asterisk+10+Function_QUEUE_MEMBER&linkCreation=true&fromPageId=19005740" class="createlink">Asterisk 10 Function_QUEUE_MEMBER</a><br/>
<a href="/wiki/pages/createpage.action?spaceKey=AST&title=Asterisk+10+Function_QUEUE_MEMBER_COUNT&linkCreation=true&fromPageId=19005740" class="createlink">Asterisk 10 Function_QUEUE_MEMBER_COUNT</a><br/>
<a href="/wiki/pages/createpage.action?spaceKey=AST&title=Asterisk+10+Function_QUEUE_EXISTS&linkCreation=true&fromPageId=19005740" class="createlink">Asterisk 10 Function_QUEUE_EXISTS</a><br/>
<a href="/wiki/pages/createpage.action?spaceKey=AST&title=Asterisk+10+Function_QUEUE_WAITING_COUNT&linkCreation=true&fromPageId=19005740" class="createlink">Asterisk 10 Function_QUEUE_WAITING_COUNT</a><br/>
<a href="/wiki/pages/createpage.action?spaceKey=AST&title=Asterisk+10+Function_QUEUE_MEMBER_LIST&linkCreation=true&fromPageId=19005740" class="createlink">Asterisk 10 Function_QUEUE_MEMBER_LIST</a><br/>
<a href="/wiki/pages/createpage.action?spaceKey=AST&title=Asterisk+10+Function_QUEUE_MEMBER_PENALTY&linkCreation=true&fromPageId=19005740" class="createlink">Asterisk 10 Function_QUEUE_MEMBER_PENALTY</a></p>
<h3><a name="Asterisk10Application_Queue-ImportVersion"></a>Import Version</h3>
<p>This documentation was imported from Asterisk version SVN-branch-10-r340810.</p>
</div>
<div id="commentsSection" class="wiki-content pageSection">
<div style="float: right;" class="grey">
<a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=AST">Stop watching space</a>
<span style="padding: 0px 5px;">|</span>
<a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action">Change email notification preferences</a>
</div>
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+10+Application_Queue">View Online</a>
|
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+10+Application_Queue?showComments=true&showCommentArea=true#addcomment">Add Comment</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>