© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Advanced Gateway Features Implementing Call Applications on Cisco IOS Gateways

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Call Applications Overview Call applications deployed on Cisco IOS gateways: –Tool Command Language (TCL) scripts –Voice XML-controlled Enhanced features: –Interactive Voice Response (IVR) –Call routing –No real limitation due to software development kit (SDK)

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Call Applications Overview (Cont.) Phone Phone Cisco IOS Router PSTN 1 Call is answered by Auto Attendant call application. User dials User makes choice and call is routed to phone. 4 Please specify the name of the person you want to reach! 3

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Introducing TCL TCL IVR Version 2.0 uses TCL scripts –Powerful scripting language for developing IVR applications Gathers data and processes accounting information: –Plays an audio prompt that asks callers to enter a specific type of information –Collects information as digits –Routes call depending on information Sample scripts available on Cisco.com: Detailed information for developers: 3/123cgcr/vvfax_c/Tcl_c/index.htm

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Introducing TCL (Cont.) ApplicationDescription cme-b-acd tarCisco Unified CallManager Express Basic ACD files its-CISCO TclCisco Unified CallManager Express and SRST Auto Attendant conf-express.zipCisco Unified CallManager conference express support files ApplicationDescription app_mcid zipMCID triggering from DTMF sequence or H323 facility message app-faxmail-onramp zipFax-mail on-ramp T.37 store-and-forward fax app-faxmail-offramp zipFax-mail Off-ramp T.37 store-and-forward fax

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Call Application Syntax Changes Drastic syntax change introduced with Cisco IOS Software Release 12.3(14)T Prior to Cisco IOS Software Release 12.3(14)T: –call application voice command in global configuration mode –Configuration hard to read Cisco IOS Software Release 12.3(14)T and higher: –application configuration mode with subconfiguration modes –Easier to understand and read Old syntax is automatically converted to new syntax For a complete command overview, refer to 3/123cgcr/vvfax_c/Tcl_c/ivrapp02.htm

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Call Application Syntax Changes (Cont.) ! application service aa flash:its-CISCO Tcl param operator 4002 paramspace english language en paramspace english index 0 paramspace english location flash: paramspace english prefix en param aa-pilot 4000 ! call application voice aa flash:its-CISCO Tcl call application voice aa language 0 en call application voice aa aa-pilot 4000 call application voice aa operator 4002 call application voice aa set-location en 0 flash: ! Old syntax (prior to Cisco IOS Software Release 12.3(14)T): New syntax (Cisco IOS Software Release 12.3(14)T and higher):

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Call Application Configuration Commands: Service Definition application router(config)# Enters application configuration mode service service-name service-location router(config-app)# Defines a new service using a TCL script at the specified location

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Call Application Configuration Commands: Service Parameters paramspace language {language language|index index|location location|prefix prefix} router(config-app-param)# paramspace references parameters not defined in the application itself, in this case, the global language parameter param paramter value router(config-app-param)# Sets an applications-specific parameter and associated value

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Call Application Configuration Commands: Applying Services to Dial Peers serivce service-name [out-bound] router(config-dial-peer)# Associates a call application with an inbound dial peer. If the out-bound option is used, the application will be used for outbound dial peers.

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Configuring Call Applications 1. Obtain the sample Auto Attendant script from Cisco.com. 2. Upload and uncompress the script files to the router flash. 3. Define the Auto Attendant application and define parameters. 4. Associate the application with a dial peer. Note: For other sample applications, refer to the included documentation for detailed configuration steps.

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Configuring Call Applications Scenario Phone4-2 Operator 4002 Phone CUCME Router4 PSTN Auto Attendant should answer calls to Denver Non-DID FXO 0/0/0 CUCME = Cisco Unified CallManager Express

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Step 1: Obtain the Sample Auto Attendant Script Sample auto attendant Tcl script

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Step 2: Upload and Uncompress the Script to Flash Router4#archive tar /xtract tftp:// /cme- aa tar flash:

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Step 3: Define the Application and Parameters ! application service aa flash:its-CISCO Tcl param operator 4002 paramspace english language en paramspace english index 0 paramspace english location flash: paramspace english prefix en param aa-pilot 4000 ! call application voice aa flash:its-CISCO Tcl call application voice aa language 0 en call application voice aa aa-pilot 4000 call application voice aa operator 4002 call application voice aa set-location en 0 flash: ! Old syntax: New syntax:

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Step 4: Associate the Application with a Dial Peer Router(config)#dial-peer voice 90 Router(config-dial-peer)#service aa ! dial-peer voice 90 pots service aa destination-pattern 9T port 0/0/0 !

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Verifying Call Applications (Cont.) Router#show dial-peer voice 90 VoiceEncapPeer90 peer type = voice, system default peer = FALSE, information type = voice, description = `', tag = 90, destination-pattern = `9T', answer-address = `', preference=0, CLID Restriction = None CLID Network Number = `' CLID Second Number sent CLID Override RDNIS = disabled, source carrier-id = `', target carrier-id = `', source trunk-group-label = `', target trunk-group-label = `', numbering Type = `unknown' group = 90, Admin state is up, Operation state is up, Outbound state is up, incoming called-number = `', connections/maximum = 0/unlimited, DTMF Relay = disabled, URI classes: Destination = huntstop = disabled, in bound application associated: 'aa' out bound application associated: ''

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Verifying Call Applications Router#debug voice application [Tclcommands] Router4#... *Jun 22 10:47:30.841: //212//Tcl :/Tcl_InfotagObjCmd: infotag get evt_status *Jun 22 10:47:30.841: //212//Tcl :/Tcl_InfotagGetObjCmd: infotag get evt_status *Jun 22 10:47:30.841: //212//AFW_:/vtr_ev_status: argc 2 argindex 2 *Jun 22 10:47:30.841: //212//Tcl :/Tcl_InfotagObjCmd: infotag get evt_dcdigits *Jun 22 10:47:30.841: //212//Tcl :/Tcl_InfotagGetObjCmd: infotag get evt_dcdigits *Jun 22 10:47:30.841: //212//AFW_:/vtr_ev_dcdigits: argc 2 *Jun 22 10:47:30.841: //212//AFW_:/vtr_ev_dcdigits: DCDIGITS [4001] *Jun 22 10:47:30.841: //212//Tcl :/Tcl_HandoffObjCmd: handoff callappl leg_incoming default DESTINATION=

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v Summary Call applications enable Cisco IOS gateways to offer IVR services using TCL and VXML. TCL is a powerful scripting language that can be used to develop any type of custom script. Call applications are configured in the application configuration mode. Configuring call applications includes creating a service, defining parameters, and binding the service to a dial peer. The show dial-peer voice command can be used to verify if an application is bound to a dial peer.

© 2006 Cisco Systems, Inc. All rights reserved. GWGK v