MixMonitor()

Synopsis

Record a call and mix the audio during the recording. Use of StopMixMonitor is required to guarantee the audio file is available for processing during dialplan execution.

Description

Records the audio on the current channel to the specified file.

This application does not automatically answer and should be preceeded by an application such as Answer or Progress().

Note

Icon

MixMonitor runs as an audiohook.

MIXMONITOR_FILENAME - Will contain the filename used to record.

Warning

Icon

Do not use untrusted strings such as CALLERID(num) or CALLERID(name) as part of ANY of the application's parameters. You risk a command injection attack executing arbitrary commands if the untrusted strings aren't filtered to remove dangerous characters. See function FILTER().

Syntax

MixMonitor(filename.extension,[options,[command]])

Arguments

file

filename - If filename is an absolute path, uses that path, otherwise creates the file in the configured monitoring directory from asterisk.conf.

extension

options

a - Append to the file instead of overwriting it.

b - Only save audio to the file while the channel is bridged.

B( interval ) - Play a periodic beep while this call is being recorded.

r( file ) - Use the specified file to record the receive audio feed. Like with the basic filename argument, if an absolute path isn't given, it will create the file in the configured monitoring directory.

file

t( file ) - Use the specified file to record the transmit audio feed. Like with the basic filename argument, if an absolute path isn't given, it will create the file in the configured monitoring directory.

file

i( chanvar ) - Stores the MixMonitor's ID on this channel variable.

chanvar

p - Play a beep on the channel that starts the recording.

P - Play a beep on the channel that stops the recording.

m( mailbox ) - Create a copy of the recording as a voicemail in the indicated mailbox(es) separated by commas eg. m(1111default,...). Folders can be optionally specified using the syntax: mailbox@context/folder

mailbox

command - Will be executed when the recording is over.
Any strings matching ^{X} will be unescaped to X.
All variables will be evaluated at the time MixMonitor is called.

Warning

Icon

Do not use untrusted strings such as CALLERID(num) or CALLERID(name) as part of the command parameters. You risk a command injection attack executing arbitrary commands if the untrusted strings aren't filtered to remove dangerous characters. See function FILTER().