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

# 통화 설정

> 배경음, 노이즈 캔슬링, 인식 민감도, 타임아웃, DTMF 등 통화 동작을 설정하세요.

# 통화 설정

에이전트의 통화 환경을 구성합니다. 배경 음악, 노이즈 캔슬링, 각종 타임아웃, DTMF 입력 처리 등 통화 품질과 동작에 영향을 주는 설정을 관리합니다.

## 설정 항목 요약

| 설정            | 값 범위                       | 기본값                 | 설명                                    |
| ------------- | -------------------------- | ------------------- | ------------------------------------- |
| **배경 음악**     | 프리셋 5종 + 볼륨(0 \~ 1)        | 사용 안함 (볼륨 0.5)      | 통화 중 재생되는 배경 음악                       |
| **노이즈 캔슬링**   | 사용 안함 · 일반 · 강한(타인 목소리 제거) | 강한(타인 목소리 제거)       | 배경 소음 제거 수준                           |
| **인식 민감도**    | 0.5 \~ 0.75                | 0.55                | 음성 인식 활성화 임계값                         |
| **다이얼 대기 시간** | 10 \~ 90초                  | 30초                 | 아웃바운드 발신 시 상대방 응답 대기 시간               |
| **최대 통화 시간**  | 60 \~ 900초                 | 900초 (15분)          | 한 통화의 최대 허용 시간                        |
| **무응답 대기 시간** | 10 \~ 300초                 | 30초                 | 사용자 무응답 시 통화 종료까지의 대기 시간              |
| **DTMF 타임아웃** | 1 \~ 10초                   | 3초                  | 마지막 DTMF 키 입력 후 에이전트가 응답할 때까지 기다리는 시간 |
| **DTMF 종료 키** | 0 \~ 9 · `#` · `*`         | 비활성화 (활성화 시 기본 `#`) | 이 키를 누르면 타임아웃을 기다리지 않고 즉시 에이전트가 응답    |

## 배경 음악

통화 중 에이전트 쪽에서 재생되는 배경 음악을 설정합니다. 너무 조용한 무음 환경에서 오는 어색함을 줄여 자연스러운 통화 분위기를 만드는 용도입니다.

* **프리셋**: `사용 안함`, `카페`, `사무실`, `콜센터`, `도서관` 중 선택 (기본값: 사용 안함)
* **볼륨**: `0` \~ `1` 범위에서 조절 (기본값: `0.5`)

<Tip>
  콜센터용 에이전트라면 `콜센터` 프리셋이, 일반 비즈니스 용도라면 `사무실`이 무난합니다. 불필요하게 크게 설정하면 STT 인식률이 떨어질 수 있으므로 볼륨은 기본값에서 시작해 조금씩 조정하세요.
</Tip>

## 노이즈 캔슬링

통화 중 상대방(사용자) 쪽 마이크로 들어오는 배경 소음을 제거하는 강도를 설정합니다.

| 옵션                         | 설명                              | 적합한 환경                       |
| -------------------------- | ------------------------------- | ---------------------------- |
| **사용 안함**                  | 노이즈 캔슬링을 적용하지 않음                | 이미 조용한 환경이거나, 소리 손실이 우려되는 경우 |
| **일반 노이즈 캔슬링**             | 일반적인 배경 소음만 제거                  | 사무실·가정 등 적당히 조용한 환경          |
| **강한 노이즈 캔슬링 (타인 목소리 제거)** | 배경 소음뿐 아니라 주변 사람 목소리까지 제거 (기본값) | 콜센터·매장·공공장소 등 타인의 발화가 섞이는 환경 |

<Note>
  기본값은 **강한 노이즈 캔슬링**입니다. 사용자 주변의 타인 목소리가 에이전트에게 섞여 들어가는 것을 막아주는 대신, 사용자 발화가 조용한 경우 일부 소리가 함께 눌릴 수 있습니다. 목소리가 작은 환경에서는 `일반`으로 낮춰보세요.
</Note>

## 인식 민감도

음성 활동 감지(VAD)의 민감도를 조절합니다. 값이 낮을수록 작은 소리에도 반응하고, 높을수록 명확한 발화만 인식합니다.

* **0.5**: 높은 민감도 - 작은 소리도 발화로 감지
* **0.55** (기본값): 균형 잡힌 설정
* **0.75**: 낮은 민감도 - 명확한 발화만 감지, 잡음 무시

<Note>
  새 에이전트와 v3 API의 기본값은 `0.55`입니다. 오래된 에이전트나 값이 저장되지 않은 설정에서는 런타임 기본값이 다르게 적용될 수 있으므로, 운영 중인 에이전트는 대시보드에서 값을 명시적으로 저장해 두세요.
</Note>

## 다이얼 대기 시간

아웃바운드 전화를 걸었을 때, 상대방이 응답할 때까지 기다리는 최대 시간입니다.

* **범위**: 10 \~ 90초
* **기본값**: 30초
* 설정 시간 내에 응답이 없으면 통화를 자동으로 종료합니다.

## 최대 통화 시간

한 통화의 최대 허용 시간을 설정합니다. 설정 시간에 도달하면 에이전트가 통화 종료를 안내한 뒤 전화를 끊습니다.

* **범위**: 60 \~ 900초 (1분 \~ 15분)
* **기본값**: 900초 (15분)
* 비용 관리와 무한 통화 방지에 유용합니다. 일반 상담·예약 통화는 기본값(15분)으로 충분하며, 짧은 확인 통화라면 더 낮춰 보호막을 강화할 수 있습니다.

## 무응답 대기 시간

사용자가 응답하지 않을 때, 통화를 종료하기까지 대기하는 시간입니다.

* **범위**: 10 \~ 300초
* **기본값**: 30초
* 대기 시간 동안 에이전트는 프롬프트에 따라 재촉 메시지를 보낼 수 있습니다.

## DTMF 입력 처리

사용자가 전화기 키패드로 DTMF 키를 입력할 때, 에이전트가 **언제 입력 수집을 끝내고 응답을 시작할지** 를 제어하는 설정입니다. 통화를 종료하는 기능이 아니라는 점에 유의하세요.

### 기본 동작 — DTMF 타임아웃

사용자가 DTMF 키를 누르면 에이전트는 이후 추가 입력이 들어올 수 있다고 가정하고 잠깐 기다린 뒤 응답합니다. 이 대기 시간이 **DTMF 타임아웃**입니다.

* **범위**: 1 \~ 10초
* **기본값**: 3초
* 예: 사용자가 `1234`를 빠르게 눌렀다면, 마지막 `4` 입력 후 3초가 지난 뒤 에이전트가 `"1234번을 입력하셨네요"`처럼 응답합니다. 중간에 키가 더 들어오면 타이머가 다시 초기화됩니다.

### DTMF 종료 키

기본 타임아웃 방식에서는 사용자가 마지막 키를 누른 뒤 항상 수 초를 기다려야 합니다. **DTMF 종료 키**를 활성화하면, 사용자가 지정한 키를 누르는 순간 타임아웃을 기다리지 않고 **즉시** 에이전트가 응답을 시작합니다.

* **활성화 여부**: 기본 **비활성화**
* **종료 키**: `0` \~ `9`, `#`, `*` 중 하나 (기본값: `#`)

<Tip>
  IVR 스타일로 "주민등록번호 13자리를 입력하신 뒤 **우물정자(#)** 를 눌러주세요" 처럼 프롬프트를 구성할 때 쓰면 좋습니다. 사용자가 `#`을 누르는 순간 바로 에이전트가 다음 말을 이어가므로, 고정된 타임아웃을 기다리는 것보다 훨씬 자연스럽게 흘러갑니다.
</Tip>

<Note>
  DTMF 종료 키는 **DTMF 입력 수집**만 종료시킵니다. 통화 자체는 그대로 유지되며, 통화를 끝내려면 최대 통화 시간·무응답 대기 시간 또는 에이전트 프롬프트의 종료 안내가 사용됩니다.
</Note>

## 주의사항

* 최대 통화 시간이 너무 짧으면 복잡한 상담이 중간에 끊길 수 있습니다. 에이전트의 용도에 맞게 설정하세요.
* 노이즈 캔슬링을 **강한 노이즈 캔슬링(타인 목소리 제거)** 으로 두면 주변 타인의 발화는 걸러지지만, 사용자 목소리가 작을 때 일부 발화도 함께 눌릴 수 있습니다. 사용 환경에 맞게 조절하세요.
* 인식 민감도를 너무 민감하게(값을 낮게) 설정하면 배경 소음을 사용자 발화로 오인식할 수 있습니다.

## 관련 문서

* [첫 메시지](/docs/build/conversation/first-message)
* [발화 설정](/docs/build/conversation/speech-settings)
* [DTMF 전송 도구](/docs/build/tools/builtin/send-dtmf)

***

<Accordion title="연관 검색어">
  통화 설정, call settings, 배경 음악, 노이즈 캔슬링, 최대 통화 시간, 무응답 타임아웃, VAD, 인식 민감도
</Accordion>