his section covers custom control of SIP redirect handling.

Redirect handling can be set to "Auto" or "Manual" mode.


To change the redirect handling mode of a SIP Profile:

In Manual mode. We must specify a "redirected" dialplan extension as follow:

Dialplan configuration

<extension name="outbound-route">
    <condition field="${destination number} expression="(.*)">
        <action application="export" data="sip_redirect_context=user-dialpan_name"/>
        <action application="bridge" data="sip/trunk/trunk1/$1"/>

<extension name="redirected">
          <action application="bridge" data="sofia/trunk/trunk2/${sip_redirect_contact_0}"/>



In the above example, "sip_redirect_context" Channel Variable must be set before the bridge application. This instructs the system which dialplan to look for the redirect instruction. The "user-" is a prefix which must be there literally, followed by the name of the dialplan. In the above, this dialplan must be named "dialplan_name". Once this is specified, when a SIP 3XX Redirect is received when the call is bridging, an extension named "redirected" in dialplan "dialplan_name" will be used for the redirection. Here, the bridge application uses a different trunk to establish the new leg.



In the above example, we used input Channel Variable "sip_redirect_context" to specify the dialplan name. Using the output Channel Variable "sip_redirect_contact_0" to retrieve the first redirect address. The following is a list of output Channel Variables that can be used within the "redirected" extension:

The following further modify the "redirected" extension to log the value of each of the above output Channel Variables.

<extension name="redirected">
          <action application="log" data="The first redirect contact is ${sip_redirect_contact_0}"/>
          <action application="log" data="The first redirect contact host is ${sip_redirect_contact_host_0}"/>
          <action application="log" data="SIP redirect parameters in the first redirect contact are ${sip_redirect_contact_params_0}"/>
          <action application="log" data="The first redirect dialstring is ${sip_redirect_dialstring_0}"/>
          <action application="log" data="All dialstrings ${sip_redirect_dialstring}"/> 
          <action application="log" data="To Header value ${sip_redirected_to}"/>
          <action application="bridge" data="sofia/trunk/trunk2/${sip_redirect_contact_0}"/>


If we receive the below SIP 302, the above dialplan extension will have the following output:

SIP/2.0 302 Temporarily Moved
Via: SIP/2.0/UDP;rport;branch=z9hG4bK2mNt7QyUDc5Br
From: "sipp" <sip:sipp@>;tag=a8eym43p180FK
To: <sip:1029@>;tag=32210SIPpTag011
Call-ID: 383a9dac-6e47-1231-9ca8-0800272926ff
CSeq: 46958840 INVITE
Contact: <sip:222@;transport=UDP>
Content-Length: 0



Log output:

The first redirect contact is <sip:222@;transport=UDP>

The first redirect contact host is

SIP redirect parameters in the first redirect contact are transport=UDP

The first redirect dialstring is sofia/trunk/trunk1/sip:222@;transport=UDP

All dialstrings sofia/trunk/trunk1/sip:222@;transport=UDP

To Header value <sip:222@;transport=UDP>