<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_Pickup">Asterisk 11 Application_Pickup</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_Pickup-Pickup%28%29"></a>Pickup()</h1>

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

<p>Directed extension call pickup.</p>
<h3><a name="Asterisk11Application_Pickup-Description"></a>Description</h3>



<p>This application can pickup a specified ringing channel. The channel to pickup can be specified in the following ways.</p>

<p>1) If no <em>extension</em> targets are specified, the application will pickup a channel matching the pickup group of the requesting channel.</p>

<p>2) If the <em>extension</em> is specified with a <em>context</em> of the special string <tt>PICKUPMARK</tt> (for example 10@PICKUPMARK), the application will pickup a channel which has defined the channel variable <tt>PICKUPMARK</tt> with the same value as <em>extension</em> (in this example, <tt>10</tt>).</p>

<p>3) If the <em>extension</em> is specified with or without a <em>context</em>, the channel with a matching <em>extension</em> and <em>context</em> will be picked up. If no <em>context</em> is specified, the current context will be used.</p>
<div class='panelMacro'><table class='infoMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/wiki/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><b>Note</b><br />The <em>extension</em> is typically set on matching channels by the dial application that created the channel. The <em>context</em> is set on matching channels by the channel driver for the device.</td></tr></table></div>


<h3><a name="Asterisk11Application_Pickup-Syntax"></a>Syntax</h3>

<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>Pickup(extension&amp;extension2[&amp;...])</pre>
</div></div>
<h5><a name="Asterisk11Application_Pickup-Arguments"></a>Arguments</h5>


<ul>
        <li>targets
        <ul>
                <li>extension - Specification of the pickup target.
                <ul>
                        <li>extension</li>
                        <li>context</li>
                </ul>
                </li>
                <li>extension2 - Additional specifications of pickup targets.
                <ul>
                        <li>extension2</li>
                        <li>context2</li>
                </ul>
                </li>
        </ul>
        </li>
</ul>



<h3><a name="Asterisk11Application_Pickup-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_Pickup">View Online</a>
              |
       <a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+Application_Pickup?showComments=true&amp;showCommentArea=true#addcomment">Add Comment</a>
           </div>
</div>
</div>
</div>
</div>
</body>
</html>