Skip to main content



The module implements userspy application which provides persistent eavesdrop on all channels bridged to a certain user using mod_dptools: eavesdrop.

Click here to expand Table of Contents


  • Tell FreeSWITCH to compile this module by editing modules.conf in /usr/src/freeswitch/trunk and uncomment:
  • Recompile with make ; make install
  • Load the modul by uncommenting the following in modules.conf.xml:
<load module="mod_spy"/>  
  • Restart FreeSWITCH or load the module manually with 'load mod_spy' command.

Dialplan Application

  • userspy

In the first parameter of the application you can specify the user@domain for spying, and the second (optional) parameter is a uuid just like with eavesdrop to spy on an already existing channel for that user. When there is no active channel for the user, the spying channel hear moh until new channel bridged with the user or hangup.


<action application="userspy" data="1000@ ${hash(select/${domain_name}-spymap/1000)}"/>


  • userspy_show

This command show you the current spyers.


1000@ : 54995932-2a7c-11de-af08-93e49196b898

1 total spy

100@ is the user@domain supplied to userspy application, and 54995932-2a7c-11de-af08-93e49196b898 is the uuid of the spyer's channel.