Call Us Today! 877.742.2583

Page tree
Skip to end of metadata
Go to start of metadata


Record to a file from the channel's input media stream. 

 Click to expand Table of Contents


record,Record File,<path> [<time_limit_secs>] [<silence_thresh>] [<silence_hits>]

Record is used to record voice messages, such as in a voicemail system. This application will record to a file specified by <path>.

  • time_limit_secs - (optional) is the maximum duration of the recording in seconds.
  • silence_thresh - (optional) is the energy level below which is considered silence.
  • silence_hits - (optional) is how many seconds of audio below silence_thresh will be tolerated before the recording stops. When omitted, the default value is 3 seconds.


Record app example
<action application="playback" data="/var/sounds/beep.gsm"/>
<!--default terminator is *. Keyword 'none' disables on-key termination /-->

<!--following line will set # as recording session terminator /-->
<action application="set" data="playback_terminators=#"/> 
<action application="record" data="/tmp/data.wav 20 200"/>

After recording stops the record app sets the following read-only variables:

  • record_ms — duration of most recently recorded file in milliseconds
  • record_samples — number of recorded samples
  • playback_terminator_used — TouchTone digit used to terminate recording

The record app sets no record status.

See Also