> For the complete documentation index, see [llms.txt](https://prosbcdocs.telcobridges.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prosbcdocs.telcobridges.com/telecom-references/telecom-concepts/target-recording.md).

# Target Recording

[Tmedia](https://telcobridges.com/media-gateways/products/tmedia-gateways/) units, running [Toolpack](https://telcobridges.com/products/development-platforms-tdev/) software and the [Gateway](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/sip-voip/tb-media-gateway/README.md) 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](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/operations/tb-streamserver/README.md) application configured to be running (it's not running by default)
* [Gateway](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/sip-voip/tb-media-gateway/README.md) application (standard with [Toolpack](https://telcobridges.com/products/development-platforms-tdev/) unless explicitly replaced by custom call handling application)

### Hardware requirements

* [Tmedia](https://telcobridges.com/media-gateways/products/tmedia-gateways/) unit with IVR DSP resources
* Starting with version 2.8.101, [Tmedia](https://telcobridges.com/media-gateways/products/tmedia-gateways/) 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](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/legacy/tctrl-version-2-7/README.md) 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](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/legacy/tctrl-version-2-7/README.md) and up only)
* Available filtering parameters:
  * Any call parameters
  * Any route parameters
  * Any routing scripts parameters

### Configuration

#### Configuration (and Accessing the recorded calls)

* [Target Recording for 3.0](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/configuration/tmedia-tdev-and-tsig-web-portal-3-0-troubleshooting/README.md#target-recording)
* [Target Recording for 2.10](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/configuration/tmedia-tdev-and-tsig-web-portal-2-10-troubleshooting/README.md#target-recording)
* [Target Recording for 2.9](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/configuration/web-portal-2-9-troubleshooting/README.md#target-recording)
* [Target Recording for 2.8](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/configuration/web-portal-2-8-troubleshooting/README.md#target-recording)

\- \[Target Recording for 2.7]\(/tmedia/configuration/tmedia-tsig-and-tdev-web-portal-2-7-tutorial-guide#target-recording)

#### Routing Scripts mode

* [routing script mini tutorial guide](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/api/routing-script-tutorial-development-guide/README.md#recording-call-legs)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://prosbcdocs.telcobridges.com/telecom-references/telecom-concepts/target-recording.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
