Voxeo Documentation - <voxeo:recordcall> Element

The <voxeo:recordcall> element is a Voxeo-specific element that lets the developer record both sides of a call. This element records both the human and the application interaction to a WAV file that is stored in Voxeo File Manager. In an on-premise installation of Prophecy , recordings are saved to the ...\Voxeo\webapps\www\MRCP\Recordings directory. This element can record to a stereo audio file and contains two 8-bit streams.

Attempting to turn on call recording when it has already been enabled results in a fatal application error. The value attribute lets you a turn recording on and off within an application.

Note: To use Voxeo-specific elements or attributes, the xmlns:voxeo attribute must be declared and mapped to the correct Voxeo namespace. For example: <vxml version="2.1" xmlns:voxeo="http://community.voxeo.com/xmlns/vxml">.

Syntax

The following code example shows the syntax for the <voxeo:recordcall> element.

<voxeo:recordcall info="myInfoCDATA" infoexpr="myInfoExpression" value="100">

Attribute Details

The following table describes the attributes for the <voxeo:recordcall> element.

info

Required: true

Type: CDATA

Default: none

Specifies information that is inserted into the filename for the resultant recorded WAV file to help to differentiate between files. ECMA values are not supported for this attribute.

Resultant audio filenames take the following format: AccountID-ApplicationID-SessionID-UserData(Info).wav.

The following filename is an sample in the preceding format: 111-22222-abcdefg1234567abcdefg1234567-MyUserDefinedInformation.wav.

infoexpr

Required: false

Type: ECMAScript Expression

Default: undefined

Specifies an ECMAScript expression that evaluates to information that is inserted into the filename for the resultant recorded WAV file to help to differentiate between files.

Resultant audio filenames take the following format: AccountID-ApplicationID-SessionID-UserData(Info).wav.

The following filename is an sample in the preceding format: 111-22222-abcdefg1234567abcdefg1234567-MyUserDefinedInformation.wav.

value

Required: true

Type: Integer

Default: none

Specifies the percentage of calls to record. A value of 100 will record all calls that come in to the application, while a value of 30 will record 3 out of every 10 calls that come in. Setting this value to " 0 " lets the developer programmatically turn call recording off within the application flow.

Valid Values: An integer value between " 0 " and 100, inclusive.

Shadow Variables

None.

Parents

<block>

Children

None.

Code Samples

The following code sample shows use of the <voxeo:recordcall> element.

<?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">

 

<form id="F1">

<block>

<!-- The value of 100 will start recording -->

<voxeo:recordcall value="100" info="Passcode" />

<prompt>

Thank you for calling.

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.

</prompt>

 

<exit />

</block>

</form>

</vxml>

See Also

VoiceXML Development Guide v2.1 Overview

Element Summary

Voxeo Support

 

The <voxeo:recordcall> element is a Voxeo-specific element that allows the developer to record both sides of a call. For more information, see <voxeo:recordcall> Element.

 
Voxeo Corporation is a technology company that specializes in providing development platforms for unified customer experience as self-service and unified communications using real-time communications applications. Voxeo's products are also available as a SaaS platform as cloud-based services using on-premise software in a private cloud, or hybrid clouds that combine both on-demand public-cloud and on-premise components. For more information, see Voxeo.com and Triplecloud.com.

 

Hardware or software installed as a private cloud geographically located on your premises.

 
Prophecy is a Voxeo 100% standards-based communications software platform for running applications for voice, text messaging (SMS), video, and mobile web. Prophecy makes it easy for companies to create, deploy, and manage DTMF and speech self-service IVR applications, while also providing support for non-voice self-service channels, including SMS. Prophecy is the only IVR platform to pass every mandatory and optional VoiceXML Forum compliance test. Prophecy is available for on-premise deployment and as Prophecy Hosting as the Voxeo worldwide hosting network. A free download of Prophecy is available at Voxeo Prophecy Download.
 

The <voxeo:recordcall> element is a Voxeo-specific element that allows the developer to record both sides of a call. For more information, see <voxeo:recordcall> Element.

 

The <voxeo:recordcall> element is a Voxeo-specific element that allows the developer to record both sides of a call. For more information, see <voxeo:recordcall> Element.

 

The <block> element is a form-item container element for executable content. For more information, see <block> Element.

 

The <voxeo:recordcall> element is a Voxeo-specific element that allows the developer to record both sides of a call. For more information, see <voxeo:recordcall> Element.

Voxeo Documentation

     Voxeo Documentation Overview
  Evolution Developer Portal
  Voxeo CXP
  Prophecy
  Development Languages
     Development Languages Overview
  VoiceXML 2.1 Development Guide
     VoiceXML Development Guide v2.1 Overview
     Platform Overview
     Creating an Application
     Voxeo File Manager
     Caching Tips and Techniques
     Cache Manager API
     Security Information
  Learning VoiceXML 2.1
  Best Practices
  Debugging Techniques
  Exceptions and Errors
  VoiceXML 2.1 Porting Guide
  VoiceXML Variables
  All Things Audio
  Outbound Dialing
  Property Guide
  GSL Grammars
  grXML Grammars
     Custom Features
     External References
  Text-To-Speech Guide
     VoIP Dialing
     Voxeo Designer User Interface
  Element Reference Guide
     Element Summary
     <assign> Element
     <audio> Element
     <block> Element
     <break> Element
     <catch> Element
     <choice> Element
     <clear> Element
     <data> Element
     <disconnect> Element
     <else> Element
     <elseif> Element
     <emphasis> Element
     <enumerate> Element
     <error> Element
     <example> Element
     <exit> Element
     <field> Element
     <filled> Element
     <foreach> Element
     <form> Element
     <goto> Element
     <grammar> Element
     <help> Element
     <if> Element
     <initial> Element
     <item> Element
     <link> Element
     <log> Element
     <mark> Element
     <media> Element
     <menu> Element
     <meta> Element
     <noinput> Element
     <nomatch> Element
     <one-of> Element
     <option> Element
     <paragraph> Element
     <param> Element
     <phoneme> Element
     <prompt> Element
     <property> Element
     <prosody> Element
     <record> Element
     <reprompt> Element
     <return> Element
     <rule> Element
     <ruleref> Element
     <say-as> Element
     <script> Element
     <sentence> Element
     <sub> Element
     <subdialog> Element
     <submit> Element
     <tag> Element
     <throw> Element
     <token> Element
     <transfer> Element
     <value> Element
     <var> Element
     <voxeo:logcontrol> Element
     <voxeo:recordcall> Element
     <vxml> Element
  CCXML 1.0 Development Guide
     CallXML 3.0 Development Guide
  Voxeo Support
     Support Quick Reference
  Registering for an Account
  Self-Help Tools
  Collecting Information
  Evolution Ticketing System
     Submitting a Support Request
     Escalating a Support Request
  Software Lifecycle and Support Policies
  Getting Further Assistance
  Voxeo Glossary
  Help on Help