Running a VoiceXML Script

The steps to run VoiceXML scripts included in the VoiceXML Example Pack are:

• Create a handler to access one of the VoiceXML tools

• Set up Interaction Attendant to activate the handler

• Call to access your script

• Experiment with different example files

Creating a handler

To create a Handler, you'll use Interaction Designer, which accesses one of the previous tools and calls a VoiceXML script.

To create a handler

1. Start Interaction Designer

2. From the File menu, select Open, and then navigate to the folder containing the Example Pack files

3. Select the file Thor.ihd and click Open.

   • Notice that this handler uses a Subroutine Initiator and calls the VoiceXML Initiate toolstep

4. Publish this handler by selecting the Activate Handler check box and choosing Custom as the Subroutine category

5. To verify that the Thor subroutine was successfully created, select the Subroutines tab at the bottom of the dialog, and choose the Custom page, as shown below, then, look for Thor in the list.

   

Modifying the custom subroutine handler

Next, modify the CustomSubroutineInitiatorRouter.ihd file to allow use of the Thor subroutine that was created in the previous steps.

From the File menu, click Open, and then navigate to the CustomSubroutineInitiatorRouter.ihd file, which can be found in the CIC install path in the \Handlers\40Handlers folder, and click Open. Note: Your CIC install path will be either \I3\IC or \Program Files (x86)\Interactive Intelligence In the Selection toolstep, add a StrEqlNoCase("Thor6," p_sSubroutineName ) statement. Add a Thor subroutine toolstep into the handler. Connect the StrEqlNoCase statement with the Thor subroutine that you just added. On the Outputs page, select p_bTransferred from the Transferred drop down.

On the Inputs page, select Interaction1 from the Call ID 1 drop down and select file://c:/VoiceXMLDocs/HelloWorld1.vxml from Document URI. (The exact path depends on where files in the Example Pack have been extracted)

Publish the handler

Set up Interaction Attendant

To access the Thor Handler, set up Interaction Attendant.

1. Start Interaction Attendant

2. From the Active Schedule, select Insert/New Operation/Run Subroutine

3. Set the Name to Subroutine Initiator – Thor6

4. Select the Digit 6 Six

5. Set the Subroutine to Thor6

6. Publish the schedule

Test the handler

To test the Thor Handler, make a call.

1. Dial into your main IVR (press * from your workstation)

2. At the main IVR prompt, press 6

3. The executing script plays, "Hello World"

Experimenting with other scripts

Now that you have created a Handler to run a VoiceXML script, you can start experimenting with other VoiceXML scripts available from the Example Pack. Or you can use your own VoiceXML scripts. Here's how to run more scripts:

1. Start Interaction Designer

2. From the File menu, click Open and then navigate to the CustomSubroutineInitiatorRouter.ihd file and click Open.

3. Edit the Thor toolstep as follows:

   On the Inputs page, set Document URI to file://c:/VoiceXMLDocs/XXX.vxml (the exact path depends on where files in the Example Pack have been extracted)

4. Publish the Handler