VoiceXML 2.1 Development GuideHome  |  Frameset Home


<voxeo:recordcall>  element

The <voxeo:recordcall> element is a proprietary extension to the VoiceXML specification 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. <voxeo: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). Note that using the <vxml xmlns:voxeo> element/attribute pairing is required for the inclusion of this extension element in your code. 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
<voxeo:recordcall info="CDATA" value="(0-100)">


attributes
infoData Type: CDATADefault: 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 'application.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
valueData 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



shadow variables
none


parents
<block>


children
none


code samples
<voxeo:recordcall> sample
<?xml version="1.0" encoding="UTF-8" ?>

<!-- declaring the 'xmlns:voxeo' attribute is required -->

<vxml version="2.1" xmlns="http://www.w3.org/2001/vxml"
    xmlns:voxeo="http://community.voxeo.com/xmlns/vxml">

<meta name="author" content="Matthew Henry"/>
<meta name="copyright" content="2005 voxeo corporation"/>
<meta name="maintainer" content="YOUR_EMAIL@HERE.COM"/>


    <form id="F1">
        <block>
            <!-- the value of 100 will start recording -->
            <voxeo:recordcall value="100" info="Passcode" />

            <prompt>
                Thank you for calling.
                Please note that all calls into this system
                are recorded for training purposes.
            </prompt>
        </block>

        <field name="F_1" type="digits?length=4">
            <prompt>
                Please enter your passcode to access the system.
            </prompt>

            <filled>
            <prompt>
              Thank you. Your passcode is being verified.
            </prompt>
            <goto nextitem="B_1"/>
            </filled>
        </field>

        <block name="B_1">
          <!-- the value of '0' will turn off recording -->
          <voxeo:recordcall value="0" info="Passcode" />

            <prompt>
                We will now grant access to the application, oh Chosen One.
            </prompt>
            <exit/>
        </block>
    </form>
</vxml>



additional links
none


  ANNOTATIONS: EXISTING POSTS
feel012
9/9/2008 10:56 PM (EDT)
I have a question..
Is <voxeo:recordcall> element extension element??
It is not a standard element??
Does it use only in voxeo vxml parser???
voxeoJohn
9/9/2008 11:17 PM (EDT)
Hi!

  Yes [b]<voxeo-recordcall>[/b] is a proprietary Voxeo element and as such it is relegated to our Prophecy platform.  Please let us know if there are any other questions, we are certainly always more then happy to assist our developers!


Regards,

John
Customer Engineer
w1redone
10/3/2008 2:39 AM (EDT)
is there a length/time limit on the recordcall parameter?
voxeoJeffK
10/3/2008 2:57 AM (EDT)
Hi,

While there is no predefined upper limit on the recordings at this time, we would ask you to keep recordings reasonable on our free staging environment.

regards,
Jeff K.
w1redone
10/4/2008 8:04 PM (EDT)
I am not having any luck recording bridged calls. Here is the code I am trying to use:

<voxeo:recordcall value="100" info="save" />
<transfer name="MyCall" dest="tel:+12225556633" bridge="true" connecttimeout="20s" maxtime="600s">  
</transfer>

Is this even possible?

Thanks!
voxeojeremyr
10/4/2008 8:48 PM (EDT)
Hi,

It sure is possible.  I went ahead and created a little application that would do that for you.  The only thing you will want to change is the phone number of the transfer destination.
[code] 
<?xml version="1.0" encoding="UTF-8" ?>

<!-- declaring the 'xmlns:voxeo' attribute is required -->

<vxml version="2.1" xmlns="http://www.w3.org/2001/vxml"
    xmlns:voxeo="http://community.voxeo.com/xmlns/vxml">

<meta name="author" content="Richmond"/>
<meta name="copyright" content="2005 voxeo corporation"/>
<meta name="maintainer" content="YOUR_EMAIL@HERE.COM"/>


    <form id="F1">
        <block>
            <!-- the value of 100 will start recording -->
            <voxeo:recordcall value="100" info="Passcode" />
            <prompt>
                Thank you for calling.
                Please note that all calls into this system
                are recorded for training purposes.
            </prompt>
        </block>

       
        <transfer name="T_1" bridge="true"
                dest="tel:+14075551234">
        <prompt> Placing the call, y'all</prompt>
      <filled>
        <if cond="T_1 == 'busy'">
            <prompt>The line is busy, Lizzie. </prompt>
            <exit/>
        <elseif cond="T_1 == 'noanswer'"/>
            <prompt> No one's home, metronome. </prompt>
        </if>
      </filled>
  </transfer>
    </form>
</vxml>[/code]

If this doesn't work for you, go ahead and open an account ticket and either attach the logs of your test call or give us the time of the call and I can look it up to get a better idea of what is happening

Thanks,
Jeremy Richmond
Voxeo Support

login



© 2008 Voxeo Corporation  |  Voxeo IVR  |  VoiceXML & CCXML IVR Developer Site