Programmer's Reference Manual

Plum Voice Platform v. 3.0

© 2008 Plum Group, Inc. All rights reserved.

Using the Hosting Site

Changing Your Account Password

To change your account password, place your mouse under Account Settings and click on "Change Password".

Once you click on "Change Password", you will be prompted to enter your Current Password, the New Password you desire, and the New Password again for confirmation. Once you are finished entering your new password, click on Save.

Assigning an Application to a Phone Number

To assign an application to your phone number, place your mouse under Applications and click on "Application Configuration".

From there, click on "Edit" for one of your phone numbers.

Once you click on "Edit", you can choose the ASR Engine, TTS Engine, and the Application Source. Depending on your Application Source, you can then enter a Remote URL, Scratchpad, and Pre-Built Application for your number.

For the ASR Engine, you should only select Nuance OSR 3.0 as the ASR Engine for your application. Note: For UK numbers, only Nuance OSR 3.0 is available as an option.

For the TTS Engine, you can select AT&T Natural Voices, Cepstral Swift 4.1 (beta), Nuance RealSpeak 3.0, and Nuance RealSpeak 3.0 (beta) as options. For production applications, we highly recommend that you only use AT&T Natural Voices and Nuance RealSpeak 3.0 for your TTS Engines. Note: For UK numbers, only AT&T Natural Voices, Cepstral Swift 4.1, and Nuance RealSpeak 4.0 are available as options.

For the Application Source, you can select Remote URL, Scratchpad, and Pre-Built Application as your options. For Remote URL, you would enter the URL of your application in the textbox that's provided. For Scratchpad, you would select the scratchpad of your choice from the drop-down list of scratchpads you had created. For Pre-Built Application, you would select the pre-built application of your choice from the drop-down list of pre-built applications you had created.

Once you have chosen all your settings, click on the Save button and you should be all set to dial into your application.

Pre-Built Applications

Pre-built applications are customizable predefined phone applications that allow you to manage prompt audio files, web services and various aspects of the call flow.

To begin creating your pre-built application, first place your mouse under Applications and click on Pre-Built Applications.

From there, enter the application name in the textbox, select the pre-built application template from the drop-down menu, and then click on the Create Application button.

You should see a list of instructions for the Pre-Built Application on how to configure the call flow, configure the error handlers, review the audio configurations, and integrate your data.

Click on the Callflow tab to begin configuration of your call flow. Here, you can click on any of the callflow elements to upload an audio file or change the text that gets played to the user.

Once you are finished making your configurations to the call flow, you can click on the Error Handlers tab to configure the error handler messages that get played during specific events in the call flow.

After configuring the call flow and error handlers, you can click on the Audio Manager tab to see all the audio files that have been uploaded for your application.

If the prompt has a caution symbol next to it, that means no audio file has been uploaded for that prompt. Clicking on Edit allows you to upload a different audio file for your prompt and change the text that gets played if no audio file is uploaded. Clicking on the Play button allows you to listen to the audio file that was uploaded for your prompt. Clicking on the Delete button allows you to delete the audio file that was attached for your prompt.

Once you have finished configuring your audio files, you can click on the Data Source. From there, you can choose to use a Remote WSDL URL or use the Plum Default Data. The Plum Default Data serves as sample data to test the Pre-Built Application when you call into it.

Once you have entered a valid WSDL and clicked "Save" to assign the WSDL to your application, you have finished completing your pre-built application and can now assign it to one of your phone numbers.

Looking Through Call Logs

When looking through the call logs, you can choose to view recent call logs, current call logs, session logs, and error logs.

When looking at the recent call logs, by default, you can see the logs for any calls that occurred in the last 5 days.

To view the contents of a recent call log, you can click on View Log for one of your recent call logs. Once you click on View Log, you would be able to see the contents of your call along with all of the call's behavior.

If there are any current calls into any of your phone numbers, you would be able to view their logs in real time by looking through current logs.

For Session Logs, you can view the raw access logs for all of your phone numbers (including all phone types: inbound, outbound, and call transfers). For Aggregate Session Logs, select the phone number (or All Phone Numbers) along with the start date and end date. Once you finished setting your options, click on View Log to view your session logs. For Daily Session Logs, select the phone number and date of the log you want to view.

From the session log, you would see the following information:

calltype ANI channum [timestamp] DNIS sessionID callStart callEnd callLength

For Error Logs, you can view the cumulative errors that have occurred for each of your calls, allowing for debugging and troubleshooting when callers report issues. To view the Aggregate Error Logs for one of your numbers, select a number from the drop-down menu, select a start date and end date, and click on View Log to view the log.