> ## 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.

# SMS 발송

> 통화 중 사용자에게 문자 메시지를 발송합니다. 동적 프롬프트 또는 고정 문장으로 작성할 수 있습니다.

# SMS 발송

SMS 발송 도구는 통화 중인 사용자에게 문자 메시지를 보냅니다. 예약 일시, 결제 링크, 안내 URL처럼 음성으로 전달하기 어려운 정보를 텍스트로 남기고 싶을 때 사용합니다.

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

## 사용 시점

* **예약 확인**: 예약 일시·장소·담당자 정보를 문자로 전달
* **링크 전달**: 결제 페이지, 양식, 자료 다운로드 URL 공유
* **정보 요약**: 주문번호·접수번호 등 핵심 정보를 기록으로 남기기
* **안내 사항**: 이용 방법, 주의 사항 등 재확인이 필요한 내용

## 설정

### 이름

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

### 설명

SMS를 **언제** 발송해야 하는지 서술합니다.

예: `고객에게 예약 정보를 문자로 전달해야 하는 경우`

### 발신번호

문자를 보낼 발신번호를 선택합니다. 조직에 등록된 번호 중 SMS 발송이 가능한 번호가 목록에 표시됩니다. 선택하지 않으면 통화에 사용된 번호 또는 조직의 기본 SMS 발신번호가 사용됩니다.

<Note>
  SMS 발송이 가능한 번호는 [번호 관리](/docs/operate/deploy/phone-numbers) 페이지에서 확인할 수 있습니다. SMS 가능 표시가 없는 번호는 발신번호로 선택할 수 없습니다.
</Note>

### 문자 내용

문자 내용은 상단 탭에서 **동적** 또는 **정적** 중 하나로 선택합니다. 기본값은 **정적**입니다.

<Tabs>
  <Tab title="동적">
    대화 맥락에 따라 문자 내용을 매번 다르게 생성합니다. 입력창에는 **LLM에게 전달할 프롬프트**를 작성합니다. 이 프롬프트를 바탕으로 실제 발송되는 문장이 통화마다 새로 만들어집니다.

    입력 예시:

    ```text theme={null}
    사용자가 예약한 일시, 장소, 담당자 이름을 포함한 예약 확인 문자를 작성해 주세요.
    마지막에는 변경 문의 안내 문구를 포함합니다.
    ```

    변수가 필요하면 `{{변수명}}` 형태로 포함할 수 있습니다. 자세한 문법은 [동적 변수](/docs/build/variables/dynamic-variables) 문서를 참고하세요.
  </Tab>

  <Tab title="정적">
    매번 동일한 고정 문장을 그대로 발송합니다. 브랜드 안내, 이용약관 링크처럼 변하지 않는 문구에 적합하며, LLM 호출을 거치지 않아 즉시 전송됩니다.

    입력 예시:

    ```text theme={null}
    [ABC] 상담 감사합니다. 자세한 안내는 https://example.com/guide 에서 확인하세요.
    ```

    정적 메시지에서도 `{{변수명}}` 형태의 동적 변수는 런타임에 치환됩니다.
  </Tab>
</Tabs>

### 이미지 첨부 (MMS)

정적 모드에서는 본문에 이미지 파일을 첨부해 MMS로 보낼 수 있습니다. 첨부 영역에 이미지를 끌어다 놓거나 파일 선택으로 추가하세요.

| 항목      | 제한             |
| ------- | -------------- |
| 형식      | JPG, PNG, WebP |
| 첨부 개수   | 최대 3장          |
| 한 장당 크기 | 2 MB           |

이미지가 첨부되면 발송 시 자동으로 MMS로 전환됩니다.

<Warning>
  MMS는 SMS·LMS와 별도 단가가 적용됩니다. 자세한 요금은 [요금제](/docs/start/pricing)에서 확인하세요.
</Warning>

<Note>
  SMS는 현재 통화 중인 사용자의 전화번호로만 전송됩니다. 별도의 수신 번호는 지정할 수 없습니다.
</Note>

### 응답 대기 방식

발송 결과를 기다릴지 선택합니다 (에이전트 데이터 필드: `responseMode`). `요청만 보내고 계속 진행(fire_and_forget)`을 선택하면 발송 요청만 보내고 결과를 기다리지 않은 채 대화를 계속 진행합니다. 자세한 동작은 [API 도구의 응답 대기 방식](/docs/build/tools/api#응답-대기-방식)을 참고하세요.

## 공통 실행 설정

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

### 실행 중 발화

SMS 발송 직전에 사용자에게 전달할 메시지를 설정합니다. 활성화하면 여러 메시지 중 하나를 에이전트가 골라 말합니다.

예: "방금 말씀드린 내용 문자로 보내드릴게요", "문자 확인 부탁드립니다"

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

SMS 발송 중 사용자 발화로 실행이 중단될지 여부를 결정합니다.

* **활성화(기본값)**: 사용자 발화가 감지되면 처리가 중단됩니다.
* **비활성화**: 발송이 끝날 때까지 대화가 멈춥니다.

<Warning>
  SMS 발송에는 별도 요금이 부과될 수 있습니다. 요금 정책은 대시보드의 요금제 페이지에서 확인해 주세요.
</Warning>

## 관련 문서

* [도구 개요](/docs/build/tools/overview)
* [DTMF 전송](/docs/build/tools/builtin/send-dtmf)

***

<Accordion title="연관 검색어">
  SMS 발송, send SMS, 문자 메시지, 문자 발송, 동적 메시지, 정적 메시지, 빌트인 도구
</Accordion>