Free VoiceXML Resource by C.a.T.S.

<www.vxml.co.za>

<training>

<voicexml tutorial>

Host Interface Exampe

Example 1

The simplest example is where an application tests the internet connectivity; whether the VXML application is able to reach the internet via a given URL. Should the application reach the internet, the PHP returns VXML to the application, which will be played back.

Should the application not reach the URL, an event "error.badfetch" is thrown, which can be caught and handled.

The PHP code looks as follow:

<?php
echo "<?xml version=\"1.0\" encoding =\"iso-8859-1\"?>";
echo "<vxml version=\"2.1\" xmlns=\"http://www.w3.org/2001/vxml\" xml:lang=\"en-AU\">";
echo "	<form>";
echo "		<block>";
echo "			<prompt>";
echo "There You have indeed reached the Internet";
echo "			</prompt>";
echo "		</block>";
echo "	</form>";
echo "</vxml>";
?>

When viewing it via an Internet Browser, it looks as follow:

  <?xml version="1.0" encoding="iso-8859-1" ?> 
- <vxml version="2.1" xmlns="http://www.w3.org/2001/vxml" xml:lang="en-AU">
- <form>
- <block>
  			<prompt> There You have indeed reached the Internet</prompt> 
  	</block>
  	</form>
  </vxml>

The VXML code looks as follow:

<!-- This section uses the goto element to reach the URI -->
<block>
<goto next="http://www.10.0.0.0/vxml/test_conn_AU.php" maxage="0" fetchhint="prefetch" fetchtimeout="2000ms"/>
</block>
<!--  Should the URI not be reached, this routine will catch the bad fetch and Handle it -->
 <catch event="error.badfetch">
 	 <prompt> The internet is down!</prompt>

Example 2

The following example is a simple hardcoded routine in PHP, and depending on the value sent by the VXML code, a specific value is played to the caller.

The basic PHP code looks as follow:

<?php
$OrderNumber = $_GET['OrderNumber']; 
echo "<?xml version=\"1.0\" encoding =\"iso-8859-1\"?>";
echo "<vxml version=\"2.1\" xmlns=\"http://www.w3.org/2001/vxml\" xml:lang=\"en-GB\">";
echo "	<form>";
echo "		<block>";
echo "			<prompt>";
if ($OrderNumber == 999 ) {
echo "Your order $OrderNumber is ready";
} elseif ($OrderNumber == 888 ) {
echo "Your order $OrderNumber is not ready yet";
} else if ($OrderNumber == 777 ) {
echo "Your order $OrderNumber has been despatched";
} else {
echo "We do not have an order with the number $OrderNumber. Sorry. Have a nice day.";
}
echo "			</prompt>";
echo "		</block>";
echo "	</form>";
echo "</vxml>";
?>

From the code it is clear that there is only 3 scenarios':

Input: 777 = "Your order $OrderNumber is ready"
Input 888 = "Your order $OrderNumber is not ready yet"
Input 999 = "Your order $OrderNumber has been despatched"

Viewing the code via an Internet Browser, the results will look like this; the URI is also given, where the relevant variable is sent in the URI.
http://www.10.0.0.0/vxml/order_status_AU.php?OrderNumber=777

  <?xml version="1.0" encoding="iso-8859-1" ?> 
- <vxml version="2.1" xmlns="http://www.w3.org/2001/vxml" xml:lang="en-AU">
- <form>
- <block>
  <prompt>Your order 777 has been dispatched</prompt> 
  </block>
  </form>
  </vxml>

http://www.10.0.0.0/vxml/order_status_AU.php?OrderNumber=888

  <?xml version="1.0" encoding="iso-8859-1" ?> 
- <vxml version="2.1" xmlns="http://www.w3.org/2001/vxml" xml:lang="en-AU">
- <form>
- <block>
  <prompt>Your order 888 is not ready yet</prompt> 
  </block>
  </form>
  </vxml>

http://www.10.0.0.0/vxml/order_status_AU.php?OrderNumber=999

  <?xml version="1.0" encoding="iso-8859-1" ?> 
- <vxml version="2.1" xmlns="http://www.w3.org/2001/vxml" xml:lang="en-AU">
- <form>
- <block>
  <prompt>Your order 999 is ready</prompt> 
  </block>
  </form>
  </vxml>

http://www.domain.com/vxml/order_status_AU.php?OrderNumber=???

  <?xml version="1.0" encoding="iso-8859-1" ?> 
- <vxml version="2.1" xmlns="http://www.w3.org/2001/vxml" xml:lang="en-AU">
- <form>
- <block>
  <prompt>We do not have an order with the number ???. Sorry. Have a nice day.
</prompt> 
  </block>
  </form>
  </vxml>

The VXML code which captures the input from the caller and handles the interaction with the web service looks as follow:

<form id="ordercheck">
<property name="timeout" value="3s" />
	<field type ="digits?length=3" name="OrderNumber">
		<prompt>Please enter your three digit order number</prompt>
		<filled>
			<submit next="http://www.10.0.0.0/vxml/order_status_AU.php" namelist="OrderNumber" maxage="0"/>
		</filled>
		<nomatch>
			<prompt>The number you have entered does not consist of three digits. Please try again</prompt>
		</nomatch>
		<noinput>
			<prompt>Sorry, the call is ending now.</prompt><exit/>
		</noinput>	
	</field>
</form>

To Search this site click here.

To Get Trained in VoiceXML click here.