Target Recording: Difference between revisions

Latest revision as of 19:01, 9 March 2018

Tmedia units, running Toolpack software and the Gateway application, permit the recording of calls.

Calls are recorded as ".wav" files on the Tmedia unit's drive.

WARNING: For this reason, target recording is recommend for troubleshooting only and should be disabled when it is not needed. In addition, recording a large amount of calls simultaneously will have an impact on the system's performance.

Use cases

Target recording is useful in a variety of applications:

Voice/line quality control
FAX quality analysis
Lawful interception
Debugging
Test calls

Software requirements

Toolpack software version 2.6 or higher
tbstreamserver application configured to be running (it's not running by default)
Gateway application (standard with Toolpack unless explicitly replaced by custom call handling application)

Hardware requirements

Tmedia unit with IVR DSP resources
Starting with version 2.8.101, Tmedia unit with IVR DSP resources or VoIP DSP resources with playing/recording licenses

Recording modes

Recording calls can be achieved using 1 of 2 methods:

Web Portal

This mode should be used for troubleshooting only.

It is easy to use but not flexible.

This mode is limited to record based on the following parameters:

Recorded files options:
- Record each leg of a call into it's own file
- Record an audio mix of both legs of a call to a single file (only available with Toolpack 2.7 and up only)
Available filtering parameters:
- By calling number
- By called number
- By incoming NAP
- By outgoing NAP

Routing script

This mode can insert recording into any existing routing script.

It is extremely flexible but requires users to modify their routing scripts.

Recorded files options:
- Record each leg of a call into it's own file
- Record an audio mix of both legs of a call to a single file (only available with Toolpack 2.7 and up only)
Available filtering parameters:
- Any call parameters
- Any route parameters
- Any routing scripts parameters

@@ Line 1: / Line 1: @@
-== Features ==
+[[Tmedia]] units, running [[Toolpack]] software and the [[TB_Media_Gateway|Gateway]] application, permit the recording of calls.
-[[Tmedia]] units, running [[Toolpack]] software and the [[TB_Media_Gateway|Gateway]] application, allow call recording.
+Calls are recorded as ".wav" files on the Tmedia unit's drive.
+'''WARNING: For this reason, target recording is recommend for troubleshooting only and should be disabled when it is not needed. In addition, recording a large amount of calls simultaneously will have an impact on the system's performance.'''
+== Use cases ==
+Target recording is useful in a variety of applications:
+* Voice/line quality control
+* FAX quality analysis
+* Lawful interception
+* Debugging
+* Test calls
-Recording options:
-* Record each leg of a call as ".wav" files on the [[Tmedia]] unit drive
-* Record an audio mix of both legs of a call to a single ".wav" file (available with [[TMG-CONTROL_Version_2.7|Toolpack 2.7]] and up only)
-Calls are being recorded to ".wav" files on the Tmedia unit's drive.
-* Calls to record can be filtered by
-** Calling number
-** Called number
-** NAP
-* Calls to record can be chosen by a routing script
 == Software requirements ==
@@ Line 16: / Line 20: @@
 * [[Toolpack_Application:tbstreamserver|tbstreamserver]] application configured to be running (it's not running by default)
 * [[TB_Media_Gateway|Gateway]] application (standard with [[Toolpack]] unless explicitly replaced by custom call handling application)
 == Hardware requirements ==
-* [[Tmedia]] unit with DSP resources
+* [[Tmedia]] unit with IVR DSP resources
+* Starting with version 2.8.101, [[Tmedia]] unit with IVR DSP resources or VoIP DSP resources with playing/recording licenses
+== Recording modes ==
+Recording calls can be achieved using 1 of 2 methods:
+=== Web Portal ===
+'''This mode should be used for troubleshooting only.'''
+It is easy to use but not flexible.
+This mode is limited to record based on the following parameters:
+* Recorded files options:
+** Record each leg of a call into it's own file
+** Record an audio mix of both legs of a call to a single file (only available with [[TMG-CONTROL_Version_2.7|Toolpack 2.7]] and up only)
+* Available filtering parameters:
+** By calling number
+** By called number
+** By incoming NAP
+** By outgoing NAP
+=== Routing script ===
+This mode can insert recording into any existing routing script.
+It is extremely flexible but requires users to modify their routing scripts.
+* Recorded files options:
+** Record each leg of a call into it's own file
+** Record an audio mix of both legs of a call to a single file (only available with [[TMG-CONTROL_Version_2.7|Toolpack 2.7]] and up only)
+* Available filtering parameters:
+** Any call parameters
+** Any route parameters
+** Any routing scripts parameters
 == Configuration ==
-Call recording can be enabled and configured from the Web Portal, through the Gateway configuration page (see Gateway tab on the left menu in the Web portal).
+=== Configuration (and Accessing the recorded calls) ===
-[[File:Target_recording_web.png]]
+*[[Toolpack:Troubleshooting_D#Target_Recording|Target Recording for 3.0]]
+*[[Toolpack:Troubleshooting_C#Target_Recording|Target Recording for 2.10]]
+*[[Toolpack:Troubleshooting_B#Target_Recording|Target Recording for 2.9]]
+*[[Toolpack:Troubleshooting_A#Target_Recording|Target Recording for 2.8]]
+<div class="mw-collapsible mw-collapsed" data-collapsetext="other versions" data-expandtext="Click here for other versions" style="width: 400px;">
+*[[Web_Portal_Tutorial_Guide_v2.7#Target Recording|Target Recording for 2.7]]
+</div>
-Optionally, recording can be controller by enabling a routing script filter.
-For more information, please refer to the [[Routing_script_tutorial:Mini_Development_Guide#Recording_call_legs|routing script mini tutorial guide]].
+=== Routing Scripts mode ===
+*[[Routing_script_tutorial:Mini_Development_Guide#Recording_call_legs|routing script mini tutorial guide]]