Javascript Example - DISA (direct inward system access)

About

Direct Inward System Access (DISA). It allows inbound callers to make internal or outbound calls.

// is a javascript comment. The comment tells the interpreter not to process the line. To un-comment a line simply remove the two forward slashes.

Examples disa.js

disa.js

var pin = "757575"; //make sure to change the PIN number.
//var pin = ""; //don't require a pin
  //if you choose not to require a pin then then you may want to add a dialplan condition for a specific caller id

var predefined_destination = ""; //example: 9999
//predefined_destination leave empty in most cases
  //Use this to define a single destination

var digitmaxlength = 0;
var timeoutpin = 7500;
var timeouttransfer = 7500;

function mycb( session, type, obj, arg ) {
   try {
       if ( type == "dtmf" ) {
         console_log( "info", "digit: "+obj.digit+"\n" );
         if ( obj.digit == "#" ) {
           //console_log( "info", "detected pound sign.\n" );
           exit = true;
           return( false );
         }

         dtmf.digits += obj.digit;

         if ( dtmf.digits.length >= digitmaxlength ) {
           exit = true;
           return( false );
         }
       }
   } catch (e) {
       console_log( "err", e+"\n" );
   }
   return( true );
} //end function mycb

//console_log( "info", "DISA Request\n" );

var dtmf = new Object( );
dtmf.digits = "";

if ( session.ready( ) ) {
  session.answer( );

  if (pin.length > 0) {
     digitmaxlength = 6;
     session.streamFile( "/usr/local/freeswitch/sounds/custom/8000/pin.wav", mycb, "dtmf");
     session.collectInput( mycb, dtmf, timeoutpin );
     //console_log( "info", "DISA pin: " + dtmf.digits + "\n" );
  }

  if (dtmf.digits == pin || pin.length == 0) {

     //console_log( "info", "DISA pin is correct\n" );

     us_ring = session.getVariable("us-ring");
     session.execute("set", "ringback="+us_ring);          //set to ringtone
     session.execute("set", "transfer_ringback="+us_ring); //set to ringtone
     session.execute("set", "hangup_after_bridge=true");

     if (predefined_destination.length == 0) {
        dtmf.digits = ""; //clear dtmf digits to prepare for next dtmf request
        digitmaxlength = 11;
        session.streamFile( "/usr/local/freeswitch/sounds/custom/8000/please_enter_the_phone_number.wav", mycb, "dtmf");
        session.collectInput( mycb, dtmf, timeouttransfer );
        console_log( "info", "DISA Transfer: " + dtmf.digits + "\n" );
        session.execute("transfer", dtmf.digits + " XML default");
     }
     else {
        session.execute("transfer", predefined_destination + " XML default");
     }

  }
  else {
     session.streamFile( "/usr/local/freeswitch/sounds/custom/8000/pin_incorrect.wav", mycb, "dtmf");
     console_log( "info", "DISA Pin: " + dtmf.digits + " is incorrect\n" );
  }

}

Add the custom directory to /usr/local/freeswitch/sounds/ and then add another directory 8000 to that so that the path shows as /usr/local/freeswitch/sounds/custom/8000/. Download the sounds files and put them in the custom/8000 directory.

 pin.wav
 pin_incorrect.wav
 please_enter_the_phone_number.wav

To call the DISA application add something like the following in the dial plan. Defines the DISA extension as (DISA) 3472. Add this to /usr/local/freeswitch/conf/dialplan/default.xml

DISA with a PIN

 <extension name="DISA">
 	<condition field="destination_number" expression="3472">
 		<action application="javascript" data="disa.js" /> 
 	</condition>
 </extension>

If you are not requiring a pin number you may want to secure access with the caller id. Make sure to change 1001 to represent the number you want to allow.

Without using a PIN

 <extension name="DISA">
 	<condition field="caller_id_number" expression="^1001$"/>
 	<condition field="destination_number" expression="3472">
 		<action application="javascript" data="disa.js" /> 
 	</condition>
 </extension>

If you're trying to gain access from outside, add something like the following to the public context:

.... add to /usr/local/freeswitch/conf/dialplan/public.xml

External access

 <extension name="DISA">
 	<condition field="caller_id_number" expression="5551234567">
 		<action application="javascript" data="/usr/local/freeswitch/java/disa.js" /> 
 		<action application="set" data="domain_name=$${domain}"/>
 		<action application="transfer" data="3472 XML default"/>
 	</condition>
 </extension>

Text.