thug0bin/pharmacy-pos-qr-system
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
pharmacy-pos-qr-system/docs/kakao-channel-integration.md
thug0bin f969756caa feat: 생년월일 필드 추가 + 카카오 스코프 확장 + 채널 연동 문서 
- 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>
2026-02-25 10:12:41 +09:00

4.7 KiB
Raw Permalink Blame History

카카오톡 채널 연동 분석

현재 상태

  • 카카오톡 채널 개설 완료
  • 앱과 채널 연결 완료

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 (현재)

  • 카카오 채널 개설 및 앱 연결
  • 카카오 스코프 심사 통과 (phone_number, birthday, birthyear)

Phase 2 (키오스크 도입 시)

  • NHN Cloud 알림톡 API 연동
  • 알림톡 템플릿 등록 (적립 완료, 포인트 사용)
  • 키오스크 적립 시 알림톡 자동 발송

Phase 3 (고객 확보 후)

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

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

# 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 대체 발송 가능 (추가 비용)