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

# sendDtmf

> ARS 안내를 만났을 때 키패드 입력을 통화로 보내요.

## 할 수 있는 일

DTMF 톤을 통화로 보내요. ARS가 번호 입력을 요구할 때 써요. `answer`를 미러링하는 명령이며,
`text` 대신 `digits`를 보내요.

## 시그니처

<CodeGroup>
  ```python Python theme={null}
  await client.send_dtmf(
      digits: str,
      message_id: str | None = None,
      request_id: str | None = None,
  ) -> None
  ```

  ```ts Node theme={null}
  await client.sendDtmf(
    digits: string,
    messageId?: string,
    requestId?: string,
  ): Promise<void>
  ```

  ```go Go theme={null}
  err := client.SendDtmf(ctx context.Context, digits, messageID, requestID string) error
  ```

  ```java Java theme={null}
  CompletableFuture<Void> sendDtmf(String digits)
  CompletableFuture<Void> sendDtmf(String digits, String messageId, String requestId)
  ```
</CodeGroup>

## 파라미터

| 이름          | 필수 | 기본값        | 설명                                |
| ----------- | -- | ---------- | --------------------------------- |
| `digits`    | 필수 | 없음         | 보낼 키패드 문자열. `0-9`, `*`, `#`만 허용해요 |
| `messageId` | 선택 | 서버 생성 UUID | 메시지 식별자. `dtmf.accepted`에 실려 돌아와요 |
| `requestId` | 선택 | 없음         | 응답·오류 프레임에 그대로 에코돼요               |

## 결과

```text theme={null}
dtmf.accepted   requestId · messageId · digits
```

<Warning>
  **톤은 발화가 아니라 `agent.turn`이 따라오지 않아요.** 접수 확인은 `dtmf.accepted`로만 받아요.
  `answer`와 다른 점이에요.
</Warning>

## 오류

| 코드                   | 클래스                 | 언제                       |
| -------------------- | ------------------- | ------------------------ |
| `dtmfDigitsRequired` | `ValidationError`   | `digits`가 비어 있음          |
| `dtmfDigitsInvalid`  | `ValidationError`   | `0-9`, `*`, `#` 외 문자가 섞임 |
| `noActiveCall`       | `NoActiveCallError` | 활성 통화가 없음                |

전부 통화를 중단시키지 않아요. `error` 이벤트로 전달되고 소켓도 닫히지 않아요.

## 주의사항

* 카드번호나 비밀번호를 보낼 수 있는 명령이에요. 로그에 `digits`를 그대로 남기지 마세요.
* 하이픈이나 공백은 허용하지 않아요. `"1234#"`처럼 붙여서 보내요.

## 관련 문서

* [answer](/developer/sdk/commands/answer)
* [이벤트](/developer/sdk/events)
* [레퍼런스](/developer/sdk/reference)