dingyu
/
Asterisk


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162
							<!DOCTYPE html>
<html>
    <head>
        <title>Asterisk Project : Asterisk 13 Application_Queue</title>
        <link rel="stylesheet" href="styles/site.css" type="text/css" />
        <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
    </head>

    <body class="theme-default aui-theme-default">
        <div id="page">
            <div id="main" class="aui-page-panel">
                <div id="main-header">
                    <div id="breadcrumb-section">
                        <ol id="breadcrumbs">
                            <li class="first">
                                <span><a href="index.html">Asterisk Project</a></span>
                            </li>
                                                    <li>
                                <span><a href="Asterisk-13-Command-Reference_29394274.html">Asterisk 13 Command Reference</a></span>
                            </li>
                                                    <li>
                                <span><a href="Asterisk-13-Dialplan-Applications_29394285.html">Asterisk 13 Dialplan Applications</a></span>
                            </li>
                                                </ol>
                    </div>
                    <h1 id="title-heading" class="pagetitle">
                                                <span id="title-text">
                            Asterisk Project : Asterisk 13 Application_Queue
                        </span>
                    </h1>
                </div>

                <div id="content" class="view">
                    <div class="page-metadata">
                        
        
            Created by <span class='author'> wikibot</span> on Aug 08, 2014
                        </div>
                    <div id="main-content" class="wiki-content group">
                    <h1 id="Asterisk13Application_Queue-Queue()">Queue()</h1>

<h3 id="Asterisk13Application_Queue-Synopsis">Synopsis</h3>

<p>Queue a call for a call queue.</p>

<h3 id="Asterisk13Application_Queue-Description">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><code>QUEUESTATUS</code> - 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 id="Asterisk13Application_Queue-Syntax">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 id="Asterisk13Application_Queue-Arguments">Arguments</h5>

<ul>
	<li><code>queuename</code></li>
	<li><code>options</code>
	<ul>
		<li><code>C</code> - Mark all calls as &quot;answered elsewhere&quot; when cancelled.</li>
		<li><code>c</code> - Continue in the dialplan if the callee hangs up.</li>
		<li><code>d</code> - data-quality (modem) call (minimum delay).</li>
		<li><code>F</code> - When the caller hangs up, transfer the <strong>called member</strong> to the specified destination and <strong>start</strong> execution at that location.
		<ul>
			<li><code>context</code></li>
			<li><code>exten</code></li>
			<li><code>priority</code></li>
		</ul>
		</li>
		<li><code>F</code> - When the caller hangs up, transfer the <strong>called member</strong> to the next priority of the current extension and <strong>start</strong> execution at that location.</li>
		<li><code>h</code> - Allow <strong>callee</strong> to hang up by pressing <code>*</code>.</li>
		<li><code>H</code> - Allow <strong>caller</strong> to hang up by pressing <code>*</code>.</li>
		<li><code>n</code> - No retries on the timeout; will exit this application and go to the next step.</li>
		<li><code>i</code> - Ignore call forward requests from queue members and do nothing when they are requested.</li>
		<li><code>I</code> - Asterisk will ignore any connected line update requests or any redirecting party update requests it may receive on this dial attempt.</li>
		<li><code>r</code> - Ring instead of playing MOH. Periodic Announcements are still made, if applicable.</li>
		<li><code>R</code> - Ring instead of playing MOH when a member channel is actually ringing.</li>
		<li><code>t</code> - Allow the <strong>called</strong> user to transfer the calling user.</li>
		<li><code>T</code> - Allow the <strong>calling</strong> user to transfer the call.</li>
		<li><code>w</code> - Allow the <strong>called</strong> user to write the conversation to disk via Monitor.</li>
		<li><code>W</code> - Allow the <strong>calling</strong> user to write the conversation to disk via Monitor.</li>
		<li><code>k</code> - Allow the <strong>called</strong> party to enable parking of the call by sending the DTMF sequence defined for call parking in <code>features.conf</code>.</li>
		<li><code>K</code> - Allow the <strong>calling</strong> party to enable parking of the call by sending the DTMF sequence defined for call parking in <code>features.conf</code>.</li>
		<li><code>x</code> - Allow the <strong>called</strong> user to write the conversation to disk via MixMonitor.</li>
		<li><code>X</code> - Allow the <strong>calling</strong> user to write the conversation to disk via MixMonitor.</li>
	</ul>
	</li>
	<li><code>URL</code> - URL will be sent to the called party if the channel supports it.</li>
	<li><code>announceoverride</code></li>
	<li><code>timeout</code> - Will cause the queue to fail out after a specified number of seconds, checked between each <code>queues.conf</code> <em>timeout</em> and <em>retry</em> cycle.</li>
	<li><code>AGI</code> - Will setup an AGI script to be executed on the calling party's channel once they are connected to a queue member.</li>
	<li><code>macro</code> - Will run a macro on the called party's channel (the queue member) once the parties are connected.</li>
	<li><code>gosub</code> - Will run a gosub on the called party's channel (the queue member) once the parties are connected.</li>
	<li><code>rule</code> - Will cause the queue's defaultrule to be overridden by the rule specified.</li>
	<li><code>position</code> - Attempt to enter the caller into the queue at the numerical position specified. <code>1</code> would attempt to enter the caller at the head of the queue, and <code>3</code> would attempt to place the caller third in the queue.</li>
</ul>


<h3 id="Asterisk13Application_Queue-SeeAlso">See Also</h3>

<ul>
	<li><a href="Asterisk-13-Application_Queue_29394417.html">Asterisk 13 Application_Queue</a></li>
	<li><a href="Asterisk-13-Application_QueueLog_29394422.html">Asterisk 13 Application_QueueLog</a></li>
	<li><a href="Asterisk-13-Application_AddQueueMember_29394418.html">Asterisk 13 Application_AddQueueMember</a></li>
	<li><a href="Asterisk-13-Application_RemoveQueueMember_29394419.html">Asterisk 13 Application_RemoveQueueMember</a></li>
	<li><a href="Asterisk-13-Application_PauseQueueMember_29394420.html">Asterisk 13 Application_PauseQueueMember</a></li>
	<li><a href="Asterisk-13-Application_UnpauseQueueMember_29394421.html">Asterisk 13 Application_UnpauseQueueMember</a></li>
	<li><a href="Asterisk-13-Function_QUEUE_VARIABLES_29394423.html">Asterisk 13 Function_QUEUE_VARIABLES</a></li>
	<li><a href="Asterisk-13-Function_QUEUE_MEMBER_29394424.html">Asterisk 13 Function_QUEUE_MEMBER</a></li>
	<li><a href="Asterisk-13-Function_QUEUE_MEMBER_COUNT_29394425.html">Asterisk 13 Function_QUEUE_MEMBER_COUNT</a></li>
	<li><a href="Asterisk-13-Function_QUEUE_EXISTS_29394426.html">Asterisk 13 Function_QUEUE_EXISTS</a></li>
	<li><a href="Asterisk-13-Function_QUEUE_WAITING_COUNT_29394427.html">Asterisk 13 Function_QUEUE_WAITING_COUNT</a></li>
	<li><a href="Asterisk-13-Function_QUEUE_MEMBER_LIST_29394428.html">Asterisk 13 Function_QUEUE_MEMBER_LIST</a></li>
	<li><a href="Asterisk-13-Function_QUEUE_MEMBER_PENALTY_29394429.html">Asterisk 13 Function_QUEUE_MEMBER_PENALTY</a></li>
</ul>


<h3 id="Asterisk13Application_Queue-ImportVersion">Import Version</h3>

<p>This documentation was imported from Asterisk Version SVN-branch-13-r420538</p>
                    </div>

                    
                </div>             </div> 
            <div id="footer">
                <section class="footer-body">
                    <p>Document generated by Confluence on Aug 11, 2014 13:45</p>
                </section>
            </div>
        </div>     </body>
</html>