CCXML Voxeo 1.0 Development Guide

| TOC

This documentation is for CCXML 1.0-Voxeo, which has been superceded by CCXML 1.0-W3C. The CCXML-Voxeo platform is not being updated any longer. The CCXML 1.0-W3C version, however, has many new features and is actively being enhanced. If you're writing a new CCXML application, you should use CCXML 1.0-W3C. Click here for the CCXML 1.0-W3C documentation.

Creating an Application

If you are unfamiliar with the Voxeo Tools and account interface, this is the right place to start. This 3-step guide will show you how you can map your code to a phone number so you can test your applications.

Step 1

The first thing you'll want to do is to log in to your account by pointing your browser to http://community.voxeo.com, and enter your username and password into the appropriate fields in the navigation bar. Don't have an account yet? The you'll need to visit our Account Signup Page first!

Once you login to your Voxeo developer account, you'll see new items in the ACCOUNT menu, including an Application Manager link. Select this link to visit Voxeo's Application Manager, where you can setup and manage your voice applications.

Step 2

Now that we have the Application Manager open, the next step is to decide which platform you will want to use for development. Choose your platform type carefully! If you aren't certain what type of platform you'll need, refer to the Platform Overview Documentation. Once you have selected your platform type, click the Next button.

Step 3

Now we will be presented the Application Settings page. Here, you'll need to give your application a name, and enter in the publicly accessible URL for your code in the Start URL 1 field. If you have a backup server where you'd like to enter a 'failover' URL mapping, enter additional URL's in Start URL 2 and Start URL 3, (note: CallXML and VoiceXML only).

If you don't already have a Web server to host your application's files, you can use Voxeo's free webhosting service to host voice application files. If you do use this feature, you'll want to use the file manager hyperlink above each Start URL when setting up your application's URL. See the VFM how-to guide for details on this interface.

At the very bottom of this screen, you'll note a drop-down menu detailing the available number types for your application. We offer a wide range of dial-in options for developers using our hosted platform. At the time of this writing, you may access your applications using any of the following methods:

Direct Dial Access - Voxeo has local access numbers across the United States to make it easier for you to test your applications. At present, we have the following local access numbers available, with more to come!

Denver, CO: (303)
Washington, DC: (301)
Orlando,FL: (407/321)
Chicago, IL: (312)
Boston, MA: (617)
Pittsburgh, PA: (412)
Houston, TX: (281)
Seattle, WA: (206)

800+PIN Access - of use to folks anywhere, and everywhere is the ubiquitous 800+PIN system. users can dial the below number, and, after entering in your unique application PIN code, will be able to access your application:

800 + PIN: (800) 289-5570 + PIN

VoIP Access - Voxeo has support for many popular softphone clients available, including Skype, and Free World Dialup. Simply download the softphone to your local machine, plug in a headset/microphone, and you can access your applications without having to dial out on your regualr phone line:

Skype VoIP: +99000936+PIN
Free World Dialup VoIP: **8691+PIN
SIP VoIP: sip:+PIN+@sip.voxeo.net

Assuming that you filled out all the fields correctly, you should get a message stating that the application was sucessfully added. You should see the assigned phone number for your application, (with PIN code, where applicable), on the bottom of the Application Manager screen. Allow up to five minutes for this to be propagated to our database, and the application should be ready for testing.

Additional Notes

The CallXML application mappings have an option for auto-answer checked by default. In some cases, you may not want the application to automatically pickup upon a user dialing in. Leave this box checked, unless you have application logic in place that handles call filtration based on called ID etc.

Token assignment, (adding the ability to initiate a call based on a HTTP request), is done by the friendly Voxeo Extreme Support Team. If you need a token assigned for your application, let us know, and we would be happy to help. And don't forget to include your account ID, and what flavor of token that you'd like, (CCXML/CallXML/VoiceXML).

Application testing and debugging is always simplified when you click on 'Application Debugger', located in the ACCOUNT menu, prior to calling your application. Make a habit out of keeping the debugger open so you don't have to guess at the reasons for application failure.

ANNOTATIONS: EXISTING POSTS

raghu.ram

5/29/2007 5:21 AM (EDT)

if i have 5 different vxml file interconnected to each other, then how to add an application.

VoxeoDante

5/29/2007 10:30 AM (EDT)

Hello,

I am looking forward to answering your questions. I would like to ask if you could help me understand what you are trying to accomplish. Are you asking how to map the different VXML documents together, or how to map the documents in Prophecy? I am not fully clear. If you can post back and clarify what you are trying to accomplish I will be able to better answer your query.

All the best,
Dante Vitulano

Platform Overview

| TOC

| Voxeo File Manager