> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.simz.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.simz.com/_mcp/server.

# Silence Handling and Auto Hangup

> How SimZ responds to a silent client after a call connects, and when it can end the call automatically.

If a call connects but the client never speaks, letting the AI agent wait indefinitely wastes call minutes and can run all the way to your max call length limit. SimZ gives every company two account-level controls that decide how the AI reacts to a silent client and whether the call can end on its own after enough silence.

## Where to configure it

These settings live in the customer portal under **Account Settings > General Settings > Call Silence Handling**.

| Setting                                   | Default | Description                                                                                                                                                                                    |
| ----------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Auto check if client is still on the line | On      | When enabled, the AI may re-engage a silent client with a short "are you still there" style prompt. When disabled, the AI never asks a client if they're still on the line because of silence. |
| Auto hang up after repeated silence       | Off     | Only takes effect when the setting above is on. When enabled, SimZ ends the call once it has checked in with a silent client the configured number of times without getting a real response.   |
| Number of silence checks before hangup    | 5       | Only shown when both settings above are on. Choose any value from 1 to 20.                                                                                                                     |

Turning off auto check also turns off auto hangup — the two are dependent, so the portal disables auto hangup whenever auto check is off, and the API coerces auto hangup to `false` in that case as well.

## Setting combinations

| Auto check | Auto hangup | Behavior                                                                                                                                                                           |
| ---------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Off        | Off         | The AI never prompts a silent client and never hangs up because of silence. The call stays connected until the client speaks, someone hangs up, or the max call length is reached. |
| Off        | On          | Not a valid combination — treated the same as Off / Off.                                                                                                                           |
| On         | Off         | The AI checks in with a silent client, but silence alone never ends the call.                                                                                                      |
| On         | On          | The AI checks in with a silent client up to the configured number of times. If there's still no response, the next silence timeout ends the call instead of prompting again.       |

## How the timing works

* SimZ waits 18 seconds of silence before treating the line as silent.
* Each time that timer fires while auto check is on, the AI sends a short check-in prompt and the silence check count goes up by one.
* The count resets to zero as soon as SimZ receives a real, non-empty transcript from the client.
* Once the count reaches your configured limit and auto hang up is on, the *next* silence timeout ends the call instead of prompting again — the AI never asks more times than the configured count.

With the default count of 5, a call that stays completely silent typically ends after around 2 minutes of continued silence, once you include the time the AI spends speaking each check-in prompt.

### Example with a threshold of 5

| Silence timeout | Check count before | Result                  | Check count after |
| --------------- | ------------------ | ----------------------- | ----------------- |
| #1              | 0                  | AI checks in            | 1                 |
| #2              | 1                  | AI checks in            | 2                 |
| #3              | 2                  | AI checks in            | 3                 |
| #4              | 3                  | AI checks in            | 4                 |
| #5              | 4                  | AI checks in            | 5                 |
| #6              | 5                  | Call ends automatically | 5                 |

## Noise and false starts

Background noise or a partial utterance can trigger speech detection without ever producing a final transcript. To stay responsive to real speech without letting noise disable silence handling entirely, SimZ pauses the silence timer as soon as any speech is detected, then waits briefly for a final transcript:

* If a final transcript arrives, the call proceeds normally and the silence check count resets.
* If no final transcript arrives, SimZ resumes the silence timer without treating the noise as a response — so a noisy line can't get stuck with silence checks effectively turned off, and noise alone never resets the check count early or counts as a real answer.

## Safety gates

Silence handling is suppressed during transfers, supervisor barge-in, and while the AI is processing or speaking. Caller speech pauses the silence timer; a final non-empty transcript resets the silence count, while speech without a final transcript rearms the timer after a short watchdog delay. All related timers are cleared as soon as the call ends.

## Call status and billing

A call ended by auto hangup reports the standard `Hangup by System` status — the same status used when a call reaches the max call length limit. See [Status Values](/resources/status-values) for the full list of call statuses.

These calls are billed under the normal call billing rules for the account, based on connected duration. There is no special AMD-style billing exemption for calls ended by silence auto hangup.