> ## 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 전송

> 통화 중 ARS/IVR 키패드 톤을 전송해 메뉴를 자동으로 탐색합니다.

# DTMF 전송

DTMF 전송 도구는 에이전트가 통화 중 ARS/IVR 키패드의 톤 신호([DTMF](/docs/build/conversation/dtmf), Dual-Tone Multi-Frequency)를 자동으로 입력할 수 있게 합니다.

어떤 키를 누를지는 다이얼로그에서 지정하지 않습니다. 에이전트가 **프롬프트에 적힌 IVR 안내 규칙**을 바탕으로 대화 맥락에 맞춰 스스로 판단해 입력합니다.

<img src="https://mintcdn.com/fleek/KJGN9YLDWG16egk5/images/screens/tools/builtin-send-dtmf.jpg?fit=max&auto=format&n=KJGN9YLDWG16egk5&q=85&s=731655a4da700fef45baa7e51a86153a" alt="DTMF 전송 설정 다이얼로그" style={{ borderRadius: "0.5rem" }} width="1920" height="1080" data-path="images/screens/tools/builtin-send-dtmf.jpg" />

## 사용 시점

* **IVR 메뉴 탐색**: 아웃바운드 통화에서 ARS 안내를 듣고 해당 번호를 입력
* **내선번호 연결**: 대표번호 수신 후 내선번호를 자동 입력
* **인증번호 입력**: 전화 기반 본인 확인 시스템에 숫자 입력
* **메뉴 트리 진입**: "상담 0번", "계좌 조회 1번"처럼 음성 안내에 맞춰 응답

## 설정

### 이름

도구를 식별할 이름입니다. 예: `send_dtmf`

### 설명

DTMF를 **언제** 전송해야 하는지 서술합니다. 어떤 키를 눌러야 하는지는 여기가 아니라 에이전트 프롬프트 본문에 적어야 합니다.

예: `ARS 안내에 따라 원하는 메뉴를 선택해야 하는 경우`

## 프롬프트에서 IVR 경로 지정

DTMF 도구는 입력할 키를 받는 별도 필드가 없습니다. 눌러야 하는 키의 순서와 조건을 **에이전트 프롬프트**에 구체적으로 적어 두면, 에이전트가 안내 음성을 듣고 해당 시점에 도구를 호출합니다.

```text theme={null}
## IVR 탐색 규칙

- 한국어 안내가 시작되면 "1"을 입력합니다.
- 고객 상담 메뉴가 안내되면 "3"을 입력합니다.
- 상담원 연결 메뉴가 안내되면 "0"을 입력합니다.
- 각 입력 사이에는 다음 안내를 끝까지 들은 뒤 입력합니다.
```

<Note>
  DTMF는 실제 전화 통화 환경에서만 동작합니다. 웹 테스트 환경에서는 톤이 전송되지 않습니다.
</Note>

## 공통 실행 설정

모든 내장 도구에는 공통 실행 설정이 있습니다.

### 실행 중 발화

DTMF가 실행되기 직전에 사용자(또는 IVR 상대)에게 전달할 메시지를 설정합니다. 대부분의 IVR 시나리오에서는 말 없이 바로 톤만 전송하므로 **비활성화 상태로 두는 것이 일반적**입니다.

### 도구 실행 중 끼어들기 허용

DTMF 전송 중 사용자 발화로 실행이 중단될지 결정합니다.

* **활성화(기본값)**: 사용자 발화가 감지되면 전송이 중단됩니다.
* **비활성화**: 주변 소음이나 IVR 안내 음성을 사용자 발화로 오탐지하는 것을 막기 위해 비활성화하는 경우가 많습니다.

<Tip>
  IVR을 자동으로 탐색하는 아웃바운드 시나리오에서는 끼어들기 허용을 비활성화하면 안내 음성이 톤 전송을 중단시키지 않아 성공률이 높아집니다.
</Tip>

## 관련 문서

* [도구 개요](/docs/build/tools/overview)
* [통화 전환](/docs/build/tools/builtin/transfer-call)
* [SMS 발송](/docs/build/tools/builtin/send-sms)

***

<Accordion title="연관 검색어">
  DTMF, DTMF 전송, send DTMF, ARS, IVR, 키패드, 톤 신호, 빌트인 도구
</Accordion>