> ## 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 노드는 플로우 중간에 고객에게 문자 메시지를 보내는 노드입니다. 고객과 대화하지 않고, 지정된 시점에 SMS를 발송한 뒤 발송 결과에 따라 다음 노드로 이동합니다.

<Note>
  SMS 노드는 고객의 응답을 기다리지 않습니다. 발송 시도 후 `요청 성공 시` 또는
  `요청 실패 시` 전환으로 넘어갑니다.
</Note>

## 언제 사용하나요

* 통화 중 **예약 확인 번호**나 **링크**를 고객 휴대폰으로 바로 보내야 할 때
* 통화 내용을 **요약한 안내 문자**를 상담 종료 직전에 보내야 할 때
* 조건 노드에서 분기한 뒤 **상황별로 다른 문자**를 보내야 할 때
* 대화 흐름 중간에 **추가 정보를 문자로 전달**해야 할 때

## 문자 내용

SMS 본문을 구성하는 방식을 두 가지 중에서 선택합니다.

<CardGroup cols={2}>
  <Card title="동적" icon="pen">
    AI가 대화 맥락에 맞춰 메시지를 직접 생성합니다.
  </Card>

  <Card title="정적" icon="align-left">
    미리 작성해둔 고정 문구를 그대로 발송합니다.
  </Card>
</CardGroup>

### 동적 메시지

AI가 메시지를 생성할 때 참고할 지침을 작성합니다. 대화 내용과 변수를 고려해 매 통화마다 상황에 맞는 문자가 만들어집니다.

**예시:**

```text theme={null}
고객의 예약 정보를 요약한 안내 문자를 작성하세요.
- 고객 이름, 예약 날짜, 예약 시간을 포함합니다.
- 정중한 어조로 2~3문장 이내로 작성합니다.
```

### 정적 메시지

미리 정해둔 제목과 본문을 그대로 발송합니다. 본문에 `{{변수명}}` 형식을 넣어두면 일부만 상황에 맞게 치환됩니다.

| 항목     | 설명                                               |
| ------ | ------------------------------------------------ |
| **제목** | 선택 사항입니다. 최대 40바이트까지 입력할 수 있고, 비워두면 제목 없이 발송됩니다. |
| **본문** | 발송할 문자 본문입니다. `{{변수명}}` 형식으로 동적 변수를 넣을 수 있습니다.   |

<Tip>
  한글은 한 글자당 2바이트, 영문·숫자는 1바이트로 계산됩니다. 본문이 90바이트를 넘으면 SMS 대신 LMS로 발송됩니다.
</Tip>

### 이미지 첨부 (MMS)

정적 모드에서는 본문에 이미지를 첨부해 MMS로 보낼 수 있습니다.

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

이미지가 첨부되면 발송 시 자동으로 MMS로 전환됩니다. MMS는 SMS·LMS와 단가가 다르므로 [요금제](/docs/start/pricing)에서 단가를 확인하세요.

## 노드 흐름

SMS 노드는 다음 순서로 작동합니다.

1. 이전 노드에서 SMS 노드로 진입
2. 설정한 방식(동적/정적)에 따라 문자 본문이 만들어짐
3. 고객 휴대폰으로 SMS 발송
4. 발송 성공 시 `요청 성공 시` 전환으로 이동
5. 발송 실패 시 `요청 실패 시` 전환으로 이동

## 전환 조건

SMS 노드는 발송 처리 결과에 따라 다음 전환을 사용합니다.

| 전환        | 사용 시점                    |
| --------- | ------------------------ |
| `요청 성공 시` | 문자 발송 요청이 정상 처리되었을 때     |
| `요청 실패 시` | 수신 번호가 없거나 발송 요청이 실패했을 때 |

<Tip>
  실패 경로를 연결해두면 고객 번호 누락이나 발송 실패가 발생했을 때 안내 노드,
  재시도 노드, 종료 노드로 명확하게 분기할 수 있습니다.
</Tip>

응답 대기 방식(노드 데이터 필드: `responseMode`)을 `요청만 보내고 계속 진행(fire_and_forget)`으로 설정하면 발송 결과를 기다리지 않고 곧바로 성공 경로로 진행합니다. 이때 결과 기반 분기는 동작하지 않으므로 함께 쓸 수 없습니다. 자세한 동작은 [API 도구의 응답 대기 방식](/docs/build/tools/api#응답-대기-방식)을 참고하세요.

## 실제 사용 예시

### 예약 확인 문자 발송

통화 중 예약을 받은 뒤, 확정 내용을 고객에게 문자로 바로 전달합니다.

**설정:**

| 항목        | 값                                                                                                                |
| --------- | ---------------------------------------------------------------------------------------------------------------- |
| **작성 방식** | 동적                                                                                                               |
| **지침**    | `고객에게 예약이 완료되었음을 안내하세요. {{customer_name}}님, {{reservation_date}} {{reservation_time}}에 예약이 확정되었습니다 형태로 작성해 주세요.` |

### 상담 자료 링크 전송

상담 종료 직전에 추가 자료가 담긴 링크를 문자로 전달합니다.

**설정:**

| 항목        | 값                                                                |
| --------- | ---------------------------------------------------------------- |
| **작성 방식** | 정적                                                               |
| **제목**    | 상담 안내 자료                                                         |
| **본문**    | `안녕하세요, {{customer_name}}님. 말씀드린 자료입니다. https://tryvox.co/guide` |

### 조건 분기별 안내 문자

조건 노드에서 고객 유형을 분기한 뒤, 유형별로 다른 SMS 노드를 연결해 서로 다른 문자를 보냅니다.

| 고객 유형 | 메시지              |
| ----- | ---------------- |
| 신규 고객 | 환영 쿠폰 + 가입 안내 링크 |
| 기존 고객 | 멤버십 혜택 안내        |

## 노드 설정

* **글로벌 노드**: 자세한 내용은 [글로벌 노드](../advanced/global-node)에서 확인하세요.

## 관련 문서

<CardGroup cols={3}>
  <Card title="SMS 발송 도구" icon="message" href="/docs/build/tools/builtin/send-sms">
    통화 중 에이전트가 상황을 판단해 직접 문자를 보낼 수 있는 도구를 확인하세요.
  </Card>

  <Card title="조건 노드" icon="code-branch" href="/docs/build/flow/nodes/condition-node">
    상황별로 다른 문자를 보내려면 조건 노드와 함께 구성하세요.
  </Card>

  <Card title="동적 변수" icon="brackets-curly" href="/docs/build/variables/dynamic-variables">
    변수로 문자 본문을 구성하는 방법을 확인하세요.
  </Card>
</CardGroup>

***

<Accordion title="연관 검색어">
  SMS 노드, send sms node, 문자 발송 노드, 문자 메시지, LMS, 플로우 SMS
</Accordion>