ChoiceView Demo application for the Voxeo Platform
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


A ChoiceView Demo Application for the Voxeo Evolution Platform


ChoiceView is a Communications-as-a-Service (CAAS) platform that allows visual information to be shared between contact center agents or IVR systems and mobile users equipped with the ChoiceView app.


The [ChoiceView REST API] ( is a REST-based service that enables visual capabilities on new and existing IVR systems. A ChoiceView-equipped IVR provides visual menus and visual responses to callers. If live assistance is needed, it can transfer the call to a contact center agent with payload delivery and continued visual sharing.

This repository contains source code for a ChoiceView implementation on the Voxeo Evolution platform.

VoxeoRadishDemo: A CCXML based application that implements the ChoiceView API. The application consists of two parts. The CCXML/jsp code drives the voice interface and handles events from the ChoiceView API. The other part consists of Java servlet that spawns a new Thread for every ChoiceView session. This Thread polls the ChoiceView session looking for status changes. If a change is detected, then API calls are made to tell the ChoiceView session to send a message to the CCXML application. This design takes into consideration the security restrictions that may exist in a distributed Environment. The API messages are being sent from the Application/Web Server to the basichttp processor. All transactions should occur inside the firewall of the runtime environment.

See the following files for the Servlet code: choiceview-webapi-voxeo-demo\VoxeoRadishDemo\WEB-INF\src\com\radish\choiceview\ choiceview-webapi-voxeo-demo\VoxeoRadishDemo\WEB-INF\src\com\radish\choiceview\


All dependencies to compile and run the application exist within the WEB-INF/lib directory of the application.

* WEB-INF/lib/choiceview-webapi-java-1.1-voxeo-alpha1.jar
* WEB-INF/lib/httpclient-4.2.1.jar
* WEB-INF/lib/httpcore-4.2.1.jar
* WEB-INF/lib/jackson-core-asl-1.9.9.jar
* WEB-INF/lib/jackson-mapper-asl-1.9.9.jar
* WEB-INF/lib/scert-


MIT License

Building the Application

The application should build "as-is" assuming that the correct runtime support file has been exported to your local development environment. There is a zip file for Tomcat6, WebLogic and WebSphere. You may need to adjust your build path to include the files in the "Dependencies" Section.

Running the Application

To use the VoxeoRadishDemo application, you must have a mobile device with the latest ChoiceView client installed. You should know the phone number of the mobile device, or the phone number that the ChoiceView client is configured to use. The client must be configured to use the ChoiceView development server. On iOS devices, press Settings, then Advanced, then change the server field to On Android devices, press the menu button, then Settings, then scroll down to the server field and change it to

Then call the phone number associated with the Voxeo Evolution platform. You will be prompted to press the "Start" button on your mobile device client. If configured correctly, you should see "ChoiceView Agent Connected" and you will be presented with the Main Menu. Now, you can tap a selection on the mobile client as well as interact with the Voice Application.

Contact Information

If you want more information on ChoiceView, or want access to the ChoiceView REST API, contact us.

Radish Systems, LLC