CallXML 2.0 Development Guide

Home | Frameset Home

This documentation is for CallXML 2, which has been superceded by CallXML 3. The CallXML 2 language is not being updated any longer. CallXML 3, however, has many new features and is actively being enhanced. If you're writing a new CallXML application, you should use CallXML 3. Click here for the CallXML 3.0 documentation.

<recordcall> element

The <recordcall>element is a new element that allows the developer to record both sides of a call, recording the human and the application interaction to a wav file that is stored in the developer's Voxeo File Manager in the 'recordings' subdirectory. <recordcall> can record to a stereo audio file and contains *two* 8-bit streams, (note that two 8-bit streams is not the same as recording in 16 bit). Also be aware that attempting to 'turn on' call recording while it has already been enabled will result in a fatal application error. However, you are free to turn it on and off at your leisure within the application by using the 'value' attribute.

usage

attributes

info	Data Type: CDATA	Default: Required
	The 'info' attribute allows the developer to specify information that is inserted into the resultant recorded wav filename that makes identification easier. Note that ECMA values are NOT supported; (for instance, specifying the 'info' attribute with a value of 'MyVar' is not valid). Resultant audio filenames will be in the following format: AccountID -ApplicationID-SessionID-UserData(Info).wav As such, a sample file might well look like this: 111-22222-abcdefg1234567abcdefg1234567-MyUserDefinedInformation.wav
value	Data Type: (0-100)	Default: Required
	The 'value' attribute specifies what percentage of calls will be recorded. Setting this value to '100' will record all calls that hit the application, while setting it to '30' will record 3 out of 10 calls that come in. Setting this value to '0' allows the developer to programmatically turn call recording on and off within the application flow.

possible events

none

code samples

<recordcall> sample

<?xml version="1.0" encoding="UTF-8"?>

<callxml version="2.0">
<block repeat="3">
<recordcall value="100" info="MyFile"/>
<text termdigits="123">
Hey, you are being recorded, jerky!
Press one to turn off recording, or press two to continue.
</text>

<ontermdigit value="1">
<recordcall value="0" info="MyFile"/>
<text>
Okay already, no more recording.
</text>
</ontermdigit>

<ontermdigit value="2">
<text>
You are so vain.
</text>
</ontermdigit>

</block>
</callxml>

additional links

none

ANNOTATIONS: EXISTING POSTS

0 posts - click the button below to add a note to this page