<html>
<head>
    <base href="https://wiki.asterisk.org/wiki">
            <link rel="stylesheet" href="/wiki/s/en/2172/18/9/_/styles/combined.css?spaceKey=AST&amp;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+11+Application_Queue">Asterisk 11 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="Asterisk11Application_Queue-Queue%28%29"></a>Queue()</h1>

<h3><a name="Asterisk11Application_Queue-Synopsis"></a>Synopsis</h3>

<p>Queue a call for a call queue.</p>
<h3><a name="Asterisk11Application_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>QUEUESTATUS - The status of the call as a text string.
        <ul>
                <li>TIMEOUT</li>
                <li>FULL</li>
                <li>JOINEMPTY</li>
                <li>LEAVEEMPTY</li>
                <li>JOINUNAVAIL</li>
                <li>LEAVEUNAVAIL</li>
                <li>CONTINUE</li>
        </ul>
        </li>
</ul>


<h3><a name="Asterisk11Application_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="Asterisk11Application_Queue-Arguments"></a>Arguments</h5>


<ul>
        <li>queuename</li>
        <li>options
        <ul>
                <li>C - Mark all calls as "answered elsewhere" when cancelled.</li>
                <li>c - Continue in the dialplan if the callee hangs up.</li>
                <li>d - data-quality (modem) call (minimum delay).</li>
                <li>F - When the caller hangs up, transfer the <b>called member</b> to the specified destination and <b>start</b> execution at that location.
                <ul>
                        <li>context</li>
                        <li>exten</li>
                        <li>priority</li>
                </ul>
                </li>
                <li>F - When the caller hangs up, transfer the <b>called member</b> to the next priority of the current extension and <b>start</b> execution at that location.</li>
                <li>h - Allow <b>callee</b> to hang up by pressing <tt>*</tt>.</li>
                <li>H - Allow <b>caller</b> to hang up by pressing <tt>*</tt>.</li>
                <li>n - No retries on the timeout; will exit this application and go to the next step.</li>
                <li>i - Ignore call forward requests from queue members and do nothing when they are requested.</li>
                <li>I - Asterisk will ignore any connected line update requests or any redirecting party update requests it may receive on this dial attempt.</li>
                <li>r - Ring instead of playing MOH. Periodic Announcements are still made, if applicable.</li>
                <li>R - Ring instead of playing MOH when a member channel is actually ringing.</li>
                <li>t - Allow the <b>called</b> user to transfer the calling user.</li>
                <li>T - Allow the <b>calling</b> user to transfer the call.</li>
                <li>w - Allow the <b>called</b> user to write the conversation to disk via Monitor.</li>
                <li>W - Allow the <b>calling</b> user to write the conversation to disk via Monitor.</li>
                <li>k - 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>K - 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>x - Allow the <b>called</b> user to write the conversation to disk via MixMonitor.</li>
                <li>X - Allow the <b>calling</b> user to write the conversation to disk via MixMonitor.</li>
        </ul>
        </li>
        <li>URL - URL will be sent to the called party if the channel supports it.</li>
        <li>announceoverride</li>
        <li>timeout - 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>AGI - Will setup an AGI script to be executed on the calling party's channel once they are connected to a queue member.</li>
        <li>macro - Will run a macro on the calling party's channel once they are connected to a queue member.</li>
        <li>gosub - Will run a gosub on the calling party's channel once they are connected to a queue member.</li>
        <li>rule - Will cause the queue's defaultrule to be overridden by the rule specified.</li>
        <li>position - 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="Asterisk11Application_Queue-SeeAlso"></a>See Also</h3>


<ul>
        <li><a href="/wiki/display/AST/Asterisk+11+Application_Queue" title="Asterisk 11 Application_Queue">Asterisk 11 Application&#95;Queue</a></li>
        <li><a href="/wiki/pages/createpage.action?spaceKey=AST&amp;title=Asterisk+11+Application_QueueLog&amp;linkCreation=true&amp;fromPageId=20187058" class="createlink">Asterisk 11 Application&#95;QueueLog</a></li>
        <li><a href="/wiki/pages/createpage.action?spaceKey=AST&amp;title=Asterisk+11+Application_AddQueueMember&amp;linkCreation=true&amp;fromPageId=20187058" class="createlink">Asterisk 11 Application&#95;AddQueueMember</a></li>
        <li><a href="/wiki/pages/createpage.action?spaceKey=AST&amp;title=Asterisk+11+Application_RemoveQueueMember&amp;linkCreation=true&amp;fromPageId=20187058" class="createlink">Asterisk 11 Application&#95;RemoveQueueMember</a></li>
        <li><a href="/wiki/pages/createpage.action?spaceKey=AST&amp;title=Asterisk+11+Application_PauseQueueMember&amp;linkCreation=true&amp;fromPageId=20187058" class="createlink">Asterisk 11 Application&#95;PauseQueueMember</a></li>
        <li><a href="/wiki/pages/createpage.action?spaceKey=AST&amp;title=Asterisk+11+Application_UnpauseQueueMember&amp;linkCreation=true&amp;fromPageId=20187058" class="createlink">Asterisk 11 Application&#95;UnpauseQueueMember</a></li>
        <li><a href="/wiki/pages/createpage.action?spaceKey=AST&amp;title=Asterisk+11+Function_QUEUE_VARIABLES&amp;linkCreation=true&amp;fromPageId=20187058" class="createlink">Asterisk 11 Function&#95;QUEUE&#95;VARIABLES</a></li>
        <li><a href="/wiki/pages/createpage.action?spaceKey=AST&amp;title=Asterisk+11+Function_QUEUE_MEMBER&amp;linkCreation=true&amp;fromPageId=20187058" class="createlink">Asterisk 11 Function&#95;QUEUE&#95;MEMBER</a></li>
        <li><a href="/wiki/pages/createpage.action?spaceKey=AST&amp;title=Asterisk+11+Function_QUEUE_MEMBER_COUNT&amp;linkCreation=true&amp;fromPageId=20187058" class="createlink">Asterisk 11 Function&#95;QUEUE&#95;MEMBER&#95;COUNT</a></li>
        <li><a href="/wiki/pages/createpage.action?spaceKey=AST&amp;title=Asterisk+11+Function_QUEUE_EXISTS&amp;linkCreation=true&amp;fromPageId=20187058" class="createlink">Asterisk 11 Function&#95;QUEUE&#95;EXISTS</a></li>
        <li><a href="/wiki/pages/createpage.action?spaceKey=AST&amp;title=Asterisk+11+Function_QUEUE_WAITING_COUNT&amp;linkCreation=true&amp;fromPageId=20187058" class="createlink">Asterisk 11 Function&#95;QUEUE&#95;WAITING&#95;COUNT</a></li>
        <li><a href="/wiki/pages/createpage.action?spaceKey=AST&amp;title=Asterisk+11+Function_QUEUE_MEMBER_LIST&amp;linkCreation=true&amp;fromPageId=20187058" class="createlink">Asterisk 11 Function&#95;QUEUE&#95;MEMBER&#95;LIST</a></li>
        <li><a href="/wiki/pages/createpage.action?spaceKey=AST&amp;title=Asterisk+11+Function_QUEUE_MEMBER_PENALTY&amp;linkCreation=true&amp;fromPageId=20187058" class="createlink">Asterisk 11 Function&#95;QUEUE&#95;MEMBER&#95;PENALTY</a></li>
</ul>


<h3><a name="Asterisk11Application_Queue-ImportVersion"></a>Import Version</h3>

<p>This documentation was imported from Asterisk Version SVN-trunk-r370322</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+11+Application_Queue">View Online</a>
              |
       <a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+Application_Queue?showComments=true&amp;showCommentArea=true#addcomment">Add Comment</a>
           </div>
</div>
</div>
</div>
</div>
</body>
</html>