Asterisk: The Future of Telephony, 2nd Edition

Name

ExtenSpy() — Listen to the audio on an extension, and optionally whisper to the calling channel

Synopsis

ExtenSpy([exten@context[,options]])

This application is used to listen to the audio going to and from an Asterisk channel. Only channels created by outgoing calls for the specified extension will be selected for spying.

While a channel is being spied upon, the following actions may be performed:

• Dialing # cycles the volume level

• Dialing * will cause the application to spy on the next available channel

The options parameter may contain zero or more of the following options:

b

Only spy on channels that are involved in a bridged call.

g(group)

Only spy on channels that contain a channel variable named SPYGROUP, which should contain group in an optional colon-delimited list.

q

Quiet mode. Tells the application not to beep or read the selected channel’s name when spying begins.

r[(basename)]

Records the channel audio to the monitor spool directory (usually /var/spool/asterisk/monitor). An optional basename set the base filename of the recordings, which defaults to chanspy.

v([value])

Adjusts the volume of the audio being listened to. The value must be in the range of 4 to -4. A negative value will make the volume quieter, while a positive value will make it louder.

w

Whisper mode. This allows the spying channel to talk to the spied-upon channel, without any other bridged channel being able to hear the audio.

W

Private whisper mode. This enables the spying channel to speak to the spied-upon channel ...