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:
TCL applications use TCL-based scripting with a proprietary Cisco API. They provide extensive call control capabilities, signaling, and generic transparency descriptor (GTD) manipulation.
VoiceXML applications use a Cisco IOS feature that acts as a browser that executes VoiceXML documents on the gateway.
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.
For inbound calls, the dial peer is matched based on incoming called-number or port. After the inbound dial peer is matched, if a DNIS map has been configured in the dial peer, the default application checks the DNIS map entries for a VoiceXML application to run.
For outbound calls, the dial peer is matched based on destination-pattern or DNIS map. If the dialed string matches the destination pattern, the call is routed according to the voice port in POTS dial peers, or the session target in VoIP dial peers.
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:
Retries the call to the next highest preference dial peer
Continues until no more matching dial peers are found
If there are dial peers with the same priority, the order is determined randomly
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.
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.
Expand the dial plan tree to view all components.
Select a zone to add an application to.
Click the Applications tab.
Right-click and choose Add from the menu. The Add Application dialog box appears.
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 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.