알림톡은 **본문을 미리 심사받는** 채널입니다. 코드를 아무리 잘 짜도 승인된 템플릿이 없으면 한 통도 나가지 않습니다. 연동 일정에서 [발신번호 등록](/ko/cookbook/sender-number)과 함께 가장 먼저 시작해야 하는 일입니다.

## 정보성만 승인된다

알림톡의 전제는 **수신자가 예상하고 있는 메시지**입니다.

| 승인되는 것 | 승인되지 않는 것 |
| --- | --- |
| 주문·결제 확인 | 할인·세일 안내 |
| 배송 상태 변경 | 신규 상품 출시 |
| 예약 확인·변경·취소 | 이벤트 참여 유도 |
| 인증번호 | 쿠폰 발급 홍보 |
| 결제 실패·연체 안내 | 재구매 권유 |
| 회원가입·탈퇴 완료 | 앱 설치 유도 |

경계가 애매한 경우도 있습니다. "장바구니에 담아두신 상품이 품절 임박입니다"는 사실 안내처럼 보이지만 구매 유도이므로 광고성으로 판단됩니다.

**광고를 보내고 싶다면** 알림톡이 아니라 [브랜드메시지](/ko/cookbook/send-brand-message)나 [광고 문자](/ko/cookbook/send-sms)를 쓰세요. 알림톡 템플릿으로 우회하려는 시도는 반려되고, 반복되면 채널 자체에 제재가 갑니다.

## 변수 설계

바뀌는 값만 변수로 두고, 나머지는 본문에 고정합니다.

```text
[#{var2}] 주문이 확인되었습니다.

■ 주문번호: #{var1}
■ 결제금액: #{var3}
■ 배송예정일: #{var4}

배송이 시작되면 다시 안내드립니다.
```

- `#{var1}` ~ `#{var8}`, 최대 여덟 개
- **본문 전체를 변수로 채우지 마세요.** `#{var1}` 하나뿐인 템플릿은 심사할 내용이 없어 반려됩니다.
- 변수 자리에 들어갈 값의 성격이 일정해야 합니다. `#{var3}` 이 어떤 발송에서는 금액, 다른 발송에서는 주소가 되면 안 됩니다.
- 발송할 때 **정의된 변수를 모두 채우세요.** 빠뜨리면 수신자가 `#{var4}` 를 그대로 봅니다.

## 등록 절차

1. 샌드고 콘솔 → **카카오 알림톡 템플릿** → 등록
2. 연결할 카카오 발신프로필 선택
3. 템플릿 이름과 **템플릿 코드** 지정 — 코드가 코드에서 쓸 식별자입니다 (`ORDER_CONFIRM_001`)
4. 카테고리 선택 (주문/배송/예약 등 실제 용도와 맞게)
5. 본문 작성, 변수 배치
6. 버튼 추가 (선택) — 채널 추가, 웹링크, 배송조회 등
7. 제출 → 심사

승인 상태가 **승인 완료**가 되어야 발송됩니다. "검토 중"인 템플릿 코드로 호출하면 `INVALID_TEMPLATE_CODE` 가 돌아옵니다.

## 자주 반려되는 문안과 고치는 법

| 반려된 문안 | 왜 | 고친 문안 |
| --- | --- | --- |
| `지금 구매하시면 20% 할인!` | 광고성 | (알림톡 대신 브랜드메시지) |
| `#{var1}` | 심사할 본문이 없음 | 고정 문구 + 변수 조합으로 재작성 |
| `안녕하세요 고객님` | 발송 목적이 불명확 | 무슨 알림인지 제목에 명시 |
| `문의는 카톡 주세요` | 외부 채널 유도 | 공식 고객센터 번호나 버튼으로 대체 |
| `#{var1}님, 이벤트 참여하세요` | 참여 유도 = 광고성 | 브랜드메시지로 이동 |

## 운영 중 템플릿 수정

본문을 바꾸면 **재심사**입니다. 운영 중인 템플릿을 고치면 승인 전까지 발송이 막힐 수 있습니다.

안전한 방법은 버전을 나누는 것입니다.

```text
ORDER_CONFIRM_001   ← 현재 운영 중
ORDER_CONFIRM_002   ← 새 문안, 심사 중
```

`002` 가 승인되면 코드에서 템플릿 코드만 교체하고, 한동안 두고 보다가 `001` 을 정리합니다. 템플릿 코드를 환경변수나 설정으로 빼 두면 배포 없이 전환할 수 있습니다.

```php
<?php

// 하드코딩하지 말고 설정으로 빼면 템플릿 교체에 배포가 필요 없다.
'templateCode' => config('sendgo.templates.order_confirm'),
```

## 다음 단계

- [카카오 알림톡 보내기](/ko/cookbook/send-alimtalk)
- [발신번호 사전등록](/ko/cookbook/sender-number)