# 카카오톡 채널 연동 분석

## 현재 상태
- 카카오톡 채널 개설 완료
- 앱과 채널 연결 완료

---

## API 종류 및 우리 서비스 적용 가능성

### 1. 채널 관계 조회 API
- **기능**: 사용자가 우리 채널을 친구 추가했는지 확인
- **우선순위**: 낮음 (나중에)
- **활용**: 적립 완료 시 채널 친구가 아니면 "채널 추가하면 생일 2배 적립 알림을 받을 수 있어요!" 유도 배너

### 2. 고객파일 관리 API
- **기능**: 채널 친구인 고객의 데이터를 카카오에 업로드 → 파트너센터에서 세그먼트 필터링
- **우선순위**: 낮음 (고객 수백 명 이상 쌓인 후)
- **활용**: 파트너센터에서 "포인트 5000 이상 고객"에게 친구톡 발송 등

#### 고객파일 스키마 (사용 가능한 키)
```
생년월일, 국가, 지역, 성별, 연령, 구매금액, 포인트, 가입일, 최근 구매일, 응모일
```
- 이 값들은 **카카오가 제공하는 것이 아님**
- **우리 DB에서 꺼내서 카카오에 업로드**하는 것
- 고객 본인이 카카오톡에서 보는 게 아니라, **약국(관리자)이 파트너센터에서 고객 분류/메시지 발송할 때 사용**하는 필터링 기준

---

## 메시지 발송 수단 비교

### 알림톡 (정보성 메시지)
| 항목 | 내용 |
|------|------|
| 대상 | 전화번호만 있으면 **누구에게나** (채널 친구 불필요) |
| 템플릿 | 카카오 사전 심사 필수 (정형화된 형식) |
| 용도 | 정보성 메시지 (적립 완료 알림, 주문 확인 등) |
| 비용 | ~8원/건 |
| 발송 방법 | NHN Cloud 알림톡 API |

### 친구톡 (마케팅 메시지)
| 항목 | 내용 |
|------|------|
| 대상 | **채널 친구에게만** |
| 템플릿 | 자유 형식 (이미지, 버튼 등 자유롭게 구성) |
| 용도 | 광고/마케팅 메시지 (생일 이벤트, 프로모션 등) |
| 비용 | ~15원/건 |
| 발송 방법 | NHN Cloud 친구톡 API 또는 카카오 파트너센터에서 직접 발송 |

### SMS/LMS (문자)
| 항목 | 내용 |
|------|------|
| 대상 | 전화번호만 있으면 누구에게나 |
| 템플릿 | 제한 없음 |
| 용도 | 범용 |
| 비용 | SMS ~20원, LMS ~50원 |
| 발송 방법 | NHN Cloud SMS API |

### 카카오 파트너센터 직접 발송
| 항목 | 내용 |
|------|------|
| 대상 | 채널 친구만 |
| 방법 | 파트너센터 웹에서 수동 발송 |
| 활용 | 고객파일 세그먼트 기반 타겟 메시지 |
| 특징 | API 개발 불필요, UI에서 직접 조작 |

---

## 우리 서비스에 적용할 알림톡 시나리오

### 시나리오 1: QR 적립 완료 알림 (현재 불필요 → 키오스크 도입 시 필요)

현재는 고객이 직접 QR 스캔 → 적립 완료 화면을 본인이 확인하므로 알림 불필요.

**키오스크 도입 후**: 약사가 키오스크에서 직접 적립 → 고객은 화면을 못 봄 → 알림톡 필요

```
[청춘약국] 마일리지 적립 완료

{고객명}님, 마일리지가 적립되었습니다.

- 적립 포인트: +3,500P
- 총 잔액: 12,800P
- 적립일시: 2026.02.25 14:30

▶ 내역 확인: https://mile.0bin.in/my-page
```

### 시나리오 2: 포인트 사용 알림

```
[청춘약국] 포인트 사용 완료

{고객명}님, 포인트가 사용되었습니다.

- 사용 포인트: -5,000P
- 남은 잔액: 7,800P

▶ 내역 확인: https://mile.0bin.in/my-page
```

### 시나리오 3: 생일 축하 (친구톡 — 채널 친구만)

```
🎂 {고객명}님, 생일 축하드립니다!

오늘 청춘약국에서 구매하시면
마일리지 포인트 2배 적립!

▶ 청춘약국 방문하기
```

---

## 구현 로드맵

### Phase 1 (현재)
- [x] 카카오 채널 개설 및 앱 연결
- [ ] 카카오 스코프 심사 통과 (phone_number, birthday, birthyear)

### Phase 2 (키오스크 도입 시)
- [ ] NHN Cloud 알림톡 API 연동
- [ ] 알림톡 템플릿 등록 (적립 완료, 포인트 사용)
- [ ] 키오스크 적립 시 알림톡 자동 발송

### Phase 3 (고객 확보 후)
- [ ] 채널 친구 추가 유도 (적립 완료 화면에 배너)
- [ ] 생일 축하 친구톡 발송 (birthday 데이터 활용)
- [ ] (선택) 카카오 고객파일 동기화 → 파트너센터 세그먼트 마케팅

---

## 필요한 환경변수 (Phase 2 시점)

```env
# NHN Cloud 알림톡
NHN_CLOUD_APP_KEY=xxx
NHN_CLOUD_SECRET_KEY=xxx
NHN_ALIMTALK_SENDER_KEY=xxx    # 카카오 채널 발신 프로필 키
NHN_ALIMTALK_TEMPLATE_CODE=xxx  # 적립 완료 템플릿 코드
```

## 참고
- 알림톡 템플릿은 카카오 비즈니스 채널 관리자에서 등록 후 검수 받아야 함 (1~2일 소요)
- NHN Cloud 알림톡 발송 시 카카오톡 미설치 사용자에게는 자동으로 SMS 대체 발송 가능 (추가 비용)
