f969756caa
- signup.html: 수집 목적 안내 카드, 생년월일(선택) 필드, 필수/선택 배지 - app.py: /api/signup에 birthday 처리, get_or_create_user birthday 파라미터 - mileage_schema.sql: users 테이블 birthday 컬럼 추가 - dbsetup.py: 기존 DB 마이그레이션 (ALTER TABLE ADD birthday) - kakao_client.py: scope에 phone_number,birthday,birthyear 추가 - privacy.html: 항목별 수집 목적 테이블, 필수/선택 구분, 9항 신설 - kakao-phone-request.md: 전화번호+생일 스코프 신청 사유 문서 - kakao-channel-integration.md: 채널 API 분석 및 알림톡 로드맵 - kakao-chanell-rest-api.md: 카카오 채널 REST API 원문 참고 문서 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
147 lines
4.7 KiB
Markdown
147 lines
4.7 KiB
Markdown
# 카카오톡 채널 연동 분석
|
|
|
|
## 현재 상태
|
|
- 카카오톡 채널 개설 완료
|
|
- 앱과 채널 연결 완료
|
|
|
|
---
|
|
|
|
## 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 대체 발송 가능 (추가 비용)
|