> ## Documentation Index
> Fetch the complete documentation index at: https://docs.callers.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Call recording and limits

> Record calls, play a recording notice, stop recording on transfer, cap call length, and control how calls end on silence or goodbye.

These settings control what Callers records and when a call ends. Most are in the agent editor under **General Settings** → **Technical Settings**.

## Settings reference

| Setting | Applies to | What it does | Default |
| - | - | - | - |
| **Record Calls** | Incoming and outgoing agents | Record the full call audio. | On |
| **Play a message that calls are being recorded** | Incoming agents | Play a short recording notice to callers before the agent speaks. | On when you turn on **Record Calls** |
| **Stop Recording When Call Is Transferred** | Incoming and outgoing agents | Stop the recording as soon as the call is transferred to another number. | Off |
| **Limit the duration of the call** (**Time In Minutes**) | Voice agents | Hang up calls that run longer than this. 1–60 minutes. | 30 minutes |
| Hang up after silence | Voice agents | End the call when the line is silent for this long. | 30 seconds (contact support to change) |

## Call recording

Recording is on by default. Recordings appear on each call in the agent's results, with playback speed controls next to the transcript.

To turn recording off or change related options:

**1. Open the technical settings**

Open the agent, click **General Settings** in the editor header, and expand **Technical Settings**.

**2. Set Record Calls**

Turn **Record Calls** on or off.

**3. Choose the related options**

For incoming agents, choose whether to **Play a message that calls are being recorded**. Turn on **Stop Recording When Call Is Transferred** if the conversation after a [transfer](https://docs.callers.ai/documentation/voice/call-transfers.md) shouldn't be recorded.

**4. Save**

Save the agent. The change applies to new calls.

> [!WARNING]
>
> Recording laws differ by country and state. Some places require every party to consent. You are responsible for giving any notice your jurisdiction requires. For outbound agents, add the notice to the agent's opening line, for example "This call may be recorded for quality purposes," and mark that step as [uninterruptible](https://docs.callers.ai/documentation/voice/conversation-dynamics.md#uninterruptible-steps) so it's heard in full. See [Compliance](https://docs.callers.ai/documentation/best-practices/compliance.md#recording-disclosure) for recording disclosure guidance.

### Access, retention, and export

* **Who can listen.** Team members need the **View transcripts and recordings** access to open recordings. See [Team and permissions](https://docs.callers.ai/documentation/account/team-and-permissions.md).
* **How long recordings are kept.** Your account's retention period applies to recordings and transcripts. See [Security and privacy](https://docs.callers.ai/documentation/account/security-and-privacy.md).
* **Sensitive data.** You can delete recordings automatically when card numbers, CVVs, or PINs are detected. See [Security and privacy](https://docs.callers.ai/documentation/account/security-and-privacy.md).
* **Getting recordings into your systems.** The `CALL_FINISHED` [webhook event](https://docs.callers.ai/documentation/webhook/webhook-events.md) includes the `recordingUrl`, and the API returns recordings for a call.

### Recording and transfers

When a call is transferred, the recording continues on the transferred call unless **Stop Recording When Call Is Transferred** is on. Calls transferred with SIP REFER always stop recording at the transfer, because Callers leaves the call. On calls without SIP, a warm transfer handoff message isn't included in the recording.

## Maximum call duration

Calls that run longer than **Time In Minutes** are hung up automatically. The limit is 1–60 minutes; the default is 30.

Calls that are [transferred](https://docs.callers.ai/documentation/voice/call-transfers.md) get an extra 150 minutes on top of this limit, so the conversation with your team isn't cut off.

> [!TIP]
>
> Set the limit a little above your longest expected call. Very long AI conversations usually mean the contact is stuck; check [Insights mode](https://docs.callers.ai/documentation/using-callers/agent-insights.md) for steps where calls loop.

## How calls end

A call ends when:

* **The agent reaches an end of the script**, such as an **End call** step.
* **The contact says goodbye or asks to end the call.** Built-in scenarios recognize goodbyes and requests to hang up, so the agent closes politely instead of continuing the script. See [Scenarios](https://docs.callers.ai/documentation/build-your-agent/agent-scenarios.md).
* **The line is silent too long.** Before that, the agent tries to re-engage after the time set in [Initiate Conversation After No Response](https://docs.callers.ai/documentation/voice/conversation-dynamics.md#when-the-contact-doesnt-respond). If the line stays silent, the agent hangs up after 30 seconds of silence by default.
* **The maximum duration is reached.**
* **The contact hangs up**, or the call is transferred.

### Hang up on silence

Callers ends calls after 30 seconds of silence by default, so dead lines don't stay open. With [Manual input only](https://docs.callers.ai/documentation/voice/keypad-input.md#manual-input-only), the timeout is at least 60 seconds to give contacts time to use the keypad.

> [!NOTE]
>
> Contact [support@callers.ai](mailto:support@callers.ai) to change the silence timeout or how many goodbye messages the agent allows before hanging up.

## Troubleshooting

> **A call has no recording**
>
> Check that **Record Calls** was on when the call happened, and that the call connected. Also check whether the recording was deleted by sensitive data rules or because the retention period passed.

> **The recording stops at the transfer**
>
> **Stop Recording When Call Is Transferred** is on, or your SIP carrier uses SIP REFER.

> **Calls end in the middle of the conversation**
>
> Check the call's hang-up reason in its details. If it was the maximum duration, raise **Time In Minutes**. If it was silence, look for steps where the agent waits for an action or the contact needs more time.

## Related

> **[Call transfers](https://docs.callers.ai/documentation/voice/call-transfers.md)**
>
> Transfers, warm handoffs, and SIP REFER.

> **[Security and privacy](https://docs.callers.ai/documentation/account/security-and-privacy.md)**
>
> Retention and sensitive data handling.

> **[Conversation dynamics](https://docs.callers.ai/documentation/voice/conversation-dynamics.md)**
>
> Silence, patience, and interruptions.

> **[Webhook events](https://docs.callers.ai/documentation/webhook/webhook-events.md)**
>
> Get the recording URL when a call ends.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.