Voice Applications

TCL and VoiceXML applications on a Cisco gateway provide Interactive Voice Response (IVR) features and call control capabilities, such as call forwarding, conference calling, and voice mail. Voice applications can be developed using one or both of the following scripting languages:

When a call comes into the gateway, the gateway attempts to match the called number with a VoiceXML or TCL application. The called number is linked to an application through a dial peer.

If several dial peers match a particular destination pattern, this is called a hunt group. The system attempts to place a call to the dial peer with the highest preference. If the call cannot be completed because of a system outage, for example, and the gatekeeper or gateway cannot be contacted, the hunt group feature performs the following:

Notes: Routes configured for inbound or outbound applications are regarded as application routes and can have an associated DNIS map for the inbound and outbound applications.

Use this procedure to configure voice applications on a gateway.

Procedure

To apply voice applications to a gateway, configure them at the zone level and apply them to ingress routes, egress routes, or route scopes. Configure voice applications from the Design View.

  1. Expand the dial plan tree to view all components.

  2. Select a zone to add an application to.

  3. Click the Applications tab.

  4. Right-click and choose Add from the menu. The Add Application dialog box appears.

  5. Enter the voice application attribute information.

General Attributes

Description

Name

The name of the voice application. Maximum value is 64 characters.

Location

Location of the TCL or VXML file. Defines the location for the designated application and passes that information to the application. Maximum value is 255 characters. The URL suffix must match the Type parameter value (for example, voiceapp.tcl or voiceapp.vxml).

Trusted

When checked, sets the security level of a VoiceXML application to trusted so that automatic number identification (ANI) is not blocked.

Type

The type of scripts used to gather caller information for authenticating the user and identifying the destination.

  • TCL -Tool Control Language-based scripting with a Cisco-proprietary API

  • VXML - Voice Extensible Markup Language is a standards-based markup language for voice browsers

TCL Paramters (N/A if Type is VXML)

Description

Pin Length

The number of characters in the personal identification number (PIN) for the designated application. This can only be set if the type is tcl. The range is 0-10.

Retry Count

The number of times a caller is permitted to reenter the personal identification number (PIN) for the designated application. This can only be set if the type is tcl. The range is1-5.

UID Length

The number of characters in the user identification number (UID) for the designated application. This can only be set if the type is tcl. The range is 1-20.

Redirect Number

The telephone number to which a call will be redirected—for example, the operator telephone number of the service provider—for the designated application. This can only be set if the type is tcl. Legal characters are 0-9, *, #, A, B, C, and D.

Warning Time

The number of seconds of warning that a user receives before the allowed calling time runs out. This can only be set if the type is tcl. The range is 10-600.

Parameter

Specifies the name portion of a name-value pair that is used by the invoked TCL script.  This can only be set if the type is tcl. Maximum value is 64 characters.

Arguments

Specifies the value portion of a name-value pair that is used by the invoked TCL script.  This can only be set if the type is tcl. Maximum value is 64 characters.

Validation State

Indicates whether the Cisco VRC server can contact the element during the Validation process.

Details

A text description that provides more information about the validation state.

Click Apply. The voice application is added to the zone parameters.