Tellme More

Examples

As we step through each code example, you will also be able to dial into Tellme and demo the code live on the Mother of Perl Tellme extension. Simply dial 1-800-555-tell, wait for the Tellme menu, and dial 1-73759. Press 1 to select the examples for tutorial 20. You will hear a greeting and a list of the examples. Press the number that corresponds with the example in the tutorial to demo it. For example, when you see:

Example 1.

You will be able to interact with the source code by dialing the Mother of Perl Tellme extension and pressing 1 on your phone. At the end of the example, you will be taken back to the Mother of Perl menu. Each example is also linked to the XML source code file where you can examine the file in your Web browser, or launch it directly into your favorite XML editor.

In addition to the live examples, you will find the source code for all examples in the tutorial20.zip file, which you can use for free to create your own VoiceXML applications.

VoiceXML

VoiceXML is an XML grammar developed by the VoiceXML Forum. VoiceXML makes it possible to access Internet content by phone and to develop speech-based telephony applications. The forum was founded by AT&T, IBM, Lucent, and Motorola and is now made up of several hundred corporate members.

Until now telephony solutions required specially trained technicians to install, configure and maintain them. Because the language was developed as an XML format, developers can integrate this new language with their existing tools. This brings telephony integration within reach of many Web developers. In fact, Webreference.com now has its very own VoiceXML channel available at https://webref.com/news thanks to Weblog 1.71.

Back to the Basics

While version 1.0 of the specification has been around since March of 2000, VoiceXML has not garnered as much hype and acceptance as WAP. Recently, however, users and developers are realizing that it's time to get back to that basic form of communication. The telephone!

That's right. The international telecommunications backbone has a common operating platform that we can fully utilize without any additional work. Almost everyone understands how to use a phone, so I decided to look into what was available for creating applications for the telephone.

Voice Portals

What I found were several companies that provide managed voice portal services to customers who want to develop voice applications but do not want to build and manage their own infrastructure. Another appealing feature is their online developer programs that allow you to test your applications for free before having to commit significant resources. This is especially helpful when many companies are still evaluating the benefit of rolling out a voice portal or application.

Tellme

Currently, Tellme.com is well funded and probably the leader in the voice portal services market. They provide free online developer tools, extensive documentation, libraries of code and tutorials to help you get started.

Once you have registered as a developer, you can immediately start coding your VoiceXML applications and testing them for free via their toll-free Tellme Studio test platform. After you've tested your application, you can launch it onto its own Tellme extension, which makes it available to anyone in the US via the main Tellme 800 number.

Platform Incompatibilities

One thing to note is that VoiceXML applications developed for Tellme.com may not work on another platform because of differences that presently exist between the VoiceXML implementations, so beware. The primary differences are in the grammar definition languages, which we will discuss in more detail later in the tutorial.

XML Rules

Since VoiceXML is XML, we must adhere to the basic XML rules. Without going into excruciating detail, you should adhere to the following basic XML guidelines:

• Must encode default entities. Default entities are reserved characters that can't be put into XML directly, but are entered using special codes. These reserved characters are <, >, &, ', and ". They are encoded respectively like so: &lt;, &gt;, &amp;, &apos;, and &quot;.

• Must have a root element. In this case, the root element is vxml.

• Elements must be properly nested. Nesting requires that you close tags in the same order you opened them or else you will get an error. Web browsers are forgiving with HTML, but XML parsers are not.

Hello World

There are 47 elements (or tags) in the VoiceXML format compared to 91 for HTML. VoiceXML is capable of something as simple as delivering content over the phone or as complex as a full-fledged E-Commerce application. No introduction is complete without a Hello World example.

Example 1.

<?xml version="1.0"?>
<vxml version="1.0"> 
  <form> 
    <block>Hello World!</block> 
  </form>
</vxml>
	

The example above will synthesize "Hello World!" and then exit. Go ahead and try it right now by calling 1-800-555-tell and then 1-73759. Then select 1 from the menu options.

Fortunately, not all VoiceXML dialogs have to be synthesized. We could have also played a recording of someone saying "Hello World" by including an audio element with a src attribute containing the url to the audio file.

<?xml version="1.0"?>
<vxml version="1.0"> 
  <form> 
    <block>
	   <audio src="hello.wav">Hello World!</audio>
	 </block> 
  </form>
</vxml>

Dialogs

Each VoiceXML document contains one or more dialogs. There are two types of dialogs, forms and menus. A form collects a user's inputs from fields, just like an HTML form. Menus present a list of choices that the user can select from, similar to a list of links that a user would select from on a Web site. More advanced applications will contain multiple dialogs and possibly even sub-dialogs.

For example, when you dial the number on the back of a credit card, it might ask you to enter your credit card number and your social security number or zip code. This is an example of a form, because the application is gathering information from you via your touch-tone phone. This information is submitted to the application, which then might give you a list of options. That's an example of a menu dialog.

By default on Tellme.com, if you create a VoiceXML document that contains multiple forms, it will execute each form in the order in which they occur. For example, let's add a second form to our Hello World example and see what happens.

Example 2.

<?xml version="1.0"?>
<vxml version="1.0"> 
  <form> 
    <block>Hello World!</block> 
  </form>
  
  <form>
    <block>My name is mud.</block>
  </form>
</vxml>

If you call Tellme, you will hear:

Tellme: Hello world, my name is mud.

Goto

Sometimes you may want to skip from one form to another in a document, but not sequentially. This is possible via the goto element. With it, you can skip to another location in the current document, or even in a separate document. As a simple example, we'll add a third form to our Hello World example that skips from the first to the third form within the document.

Example 3.

<?xml version="1.0"?>
<vxml version="1.0"> 
  <form id="hello"> 
    <block>Hello World!
	   <goto next="#jack"/>
    </block>
		
  </form>
  
  <form id="mud">
    <block>My name is mud.</block>
  </form>
	
  <form id="jack">
    <block>My name is Jack.</block>
  </form>
</vxml>		

If you demo the example on 800-555-tell, you will hear the following:

Tellme: Hello World, my name is Jack.

Prompts

At some point, you're probably going to want to get input from the user. This is where the prompt element comes in. The prompt element synthesizes the text contained in the element and waits for the user to provide input.

<prompt>Please enter your 
4 digit pin code.</prompt>

You can also play an audio file instead of synthesized text.

<prompt><audio src="pin.wav">Please enter your 
4 digit pin code.</audio></prompt>

The code above will attempt to play the pin.wav file. You're probably wondering why there's text in addition to the audio file . In the case that Tellme cannot retrieve the audio file, it will synthesize the text as a last resort, therefore, it's a good idea to include the text even when you're linking to an audio file.

<?xml version="1.0"?>
<vxml version="1.0"> 
  <form id="hello"> 
    <block>Hello World!</block>
      <field name="name">
        <prompt>What is your name?</prompt>
		</field>
  </form>
</vxml>		

The code above is not a demo on the Mother of Perl Tellme extension. That's because the code isn't ready to run yet. If you tried to run it as is, it would prompt for your name and then report that an error had occurred. This is because we have to add additional logic to handle user input and error conditions. We'll cover these issues in the next three sections.

Invalid Input

Handling forms requires more than simply gathering field input. If the user provides input that doesn't match the grammar, Tellme will look for the nomatch element. If it doesn't exist, the application will croak. The most common way to handle invalid input is to tell the user so and ask them for the information again.

<?xml version="1.0"?>
<vxml version="1.0" > 
  <form id="hello"> 
    <field name="pin"> 
      <grammar>
		    <![CDATA[
       				Four_digits
     			]]>
      </grammar>	
      <prompt>Please enter your 4 digit pin code.</prompt> 
  	   <filled>
  	     <submit next="https://www.webreference.com/cgi-bin/perl/20/pin.pl"/>
      </filled> 
      <nomatch>Invalid pin code.
        <reprompt/>
      </nomatch>
    </field> 
  </form>
</vxml>

In the example above, we are using one of the Tellme grammars, Four_digits, to regulate the input. The grammar contains rules that will cause the document to call the nomatch event unless the user enters four numbers via the phone keypad or by voice. The reprompt element repeats the last prompt, Please enter your 4 digit pin code after telling the user that they've entered an invalid PIN code. Tellme will keep reprompting the user as long as they keep entering invalid input.

Of course, if the user is repeatedly entering invalid input, giving them the same error message and prompt won't help the user any. In fact, it would be downright user unfriendly. This is why the nomatch element includes a count attribute that allows us to give the user a different warning message each time the nomatch event is called.

      <nomatch count="1">Invalid pin code.
        <reprompt/>
      </nomatch>
      <nomatch count="2">Please press or say exactly four numbers.
        <reprompt/>
      </nomatch>
      <nomatch count="3">Too many attempts. Please call back 
                         another time.
        <exit/>
      </nomatch>			
		

Now, the second time the user provides bad input, we give them more specific instructions, "Too many attempts. lease call back another time." The third time the user provides bad input, we exit the program.

No Input

Like handling invalid input, it's also critical to handle no input. Tellme calls the noinput event when the user does not provide any input after a prompt has been played.

<?xml version="1.0"?>
<vxml version="1.0" > 
  <form id="hello"> 
    <field name="pin"> 
      <grammar>
		    <![CDATA[
       				Four_digits
     			]]>
      </grammar>	
      <prompt>Please enter your 4 digit pin code.</prompt> 
  	   <filled>
  	     <submit next="https://www.webreference.com/cgi-bin/perl/20/pin.pl"/>
      </filled> 
      <noinput>
        <reprompt/>
      </noinput>
      <nomatch>Invalid pin code.
        <reprompt/>
      </nomatch>
    </field> 
  </form>
</vxml>

Like the nomatch element, if you don't handle the noinput event, your VoiceXML application will return an error when it's called. Also, like nomatch, you can set the count attribute so that a different message is played each time the user fails to provide input.

      <noinput count="1">No PIN entered.
        <reprompt/>
      </noinput>
      <noinput count="2">You must enter your PIN number to proceed.
        <reprompt/>
      </noinput>
      <noinput count="3">Please press or say exactly four numbers.
      </noinput>
		

If the noinput event is called more than 3 times, Tellme will continue to repeat the last noinput, "Please press or say exactly four numbers.", until the user provides some input.

Overview

Tellme.com provides the infrastructure and tools necessary to build your very own VoiceXML applications. Once you have registered, you will be able to test your applications via the developer studio toll-free number, 1-800-555-vxml.

Tellme is capable of synthesizing text and audio files, recognizing spoken and phone keypad (DTMF tones) input, recording spoken input, and transferring a call to another number.

Developer Registration

Registering for a developer account is very straightforward. Complete the registration form and you're up and running. Best of all, registration is completely free.

My Studio

Ok, let's get acquainted with Tellme Studio. Once you have registered and have logged into studio.tellme.com, click on the My Studio link located at the top left of the screen. You should see two tabs on the top center portion of the screen, Application url and Scratchpad.

The first tab allows you to enter a url for your VoiceXML file if it's located on a Web server. In the beginning, you will want to use the Tellme Scratchpad. It's an HTML textarea where you can tweak your VoiceXML document real-time without having to upload it to a server each time you make a modification. This is useful when you're testing a document, as we'll see later.

Within the main screen, you should also see five buttons, debug log, check syntax, grammar tools, record by phone, and edit my preferences. The debug log button comes in handy when you're trying to figure out how to fix a programming error. Once you've pasted some VoiceXML data into the scratchpad and checked the syntax (with the check syntax button), try clicking the debug log button and then testing your application. You will see the screen fill with debugging information as you run your tests. You probably won't use the grammar tools initially until you begin writing your own grammars, which we'll touch on later.

My Extensions

Once you've fully tested your VoiceXML application, you can make it available to the world via your own Tellme.com extension, which can be reached from the main tellme number, 1-800-555-tell.

To activate your extension, click on the button labeled Activate Extensions. At this point, your application will need to be accessible from a Web server so Tellme knows where to point when someone dials into your extension. Enter the url and check the Enable my Extension box and click the update button. Your VoiceXML application will then be available.

Tellme also allows you to record your voice prompts over the phone. Call Tellme Studio, 1-800-555-vxml, and say, "Record By Phone!" Then enter your developer ID and pin and record your prompts. You can then have these prompts saved or emailed to you.

Documentation and Libraries

Links to the Tellme documentation and libraries are located on the left side of the Tellme Studio pages. This information will go a long way in your quest to develop full-blown VoiceXML applications. I would highly recommend downloading and printing the VoiceXML Reference and the Grammar Reference.

Testing Your Applications

After working with Tellme Studio for about a month, I've found a really nifty way to test things out. As I develop a new application, I work almost exclusively in the Scratchpad to flesh things out. When I add a new prompt or feature, I call the Tellme Studio phone number to test it out. One really neat trick is, when you press ** on the phone after you've entered your developer ID and password, it will loop through the document over and over again. You can make changes on the fly, and listen to the results as it loops over the document. This is a great troubleshooting and testing feature. Often, I find that testing things out before I actually go through the trouble of putting it on a server saves alot of time, because what you expect it to do and how it actually works tend to be different.

Resources

• Tellme.com

• VoiceXML Reference

• Grammar Reference

• VoiceXML Forum

• VoiceXML Specification

• BeVocal

• Voxeo

• Voice Genie

• VoiceXML Central

Find a programming school near you