🎁 GiftCall 카카오비즈 알림톡+친구톡 조합 설계

1. 수작업 전화 연락 → 시간 소모, 인력 낭비
2. 종이 기록 → 정보 분실, 취합 어려움
3. 점포 대표번호 사용 → 고객 응답률 저조 (30-40%)
4. 개인 휴대폰 사용 → 개인정보 우려, 업무 부담

1. 자동 메시지 발송 → 100명 5분 내 완료
2. 디지털 기록 → 실시간 현황 파악
3. 카카오톡 사용 → 고객 응답률 향상 (70-80% 예상)
4. 시스템 통합 → 개인정보 보호, 업무 효율화

┌─────────────────┐
│  GiftCall 시스템 │ (FastAPI + Vue.js)
│  (우리 서버)     │
└────────┬────────┘
         │ API 호출
         ↓
┌─────────────────┐
│ 메시징 파트너사  │ (NHN Cloud 또는 메가버드)
│                 │
└────────┬────────┘
         │ 카카오 비즈메시지 API
         ↓
┌─────────────────┐
│  카카오 서버     │
└────────┬────────┘
         │ 카카오톡 앱
         ↓
┌─────────────────┐
│  고객 (수신자)   │
└─────────────────┘

[1단계] 주문 등록
   - 직원이 웹에서 주문 정보 입력
   - 수령자 목록 엑셀 업로드 (100명)
   ↓
[2단계] 알림톡 일괄 발송
   - "선물 보내드립니다. 배송지 확인 부탁드립니다"
   - 버튼: [채널 추가하고 답장하기]
   ↓
[3단계] 고객 회신 자동 수신
   - "주소 맞습니다"
   - "배송일 변경 부탁드립니다"
   - Webhook으로 우리 서버에 자동 저장
   ↓
[4단계] 실시간 현황 모니터링
   - 응답률 확인 (80명/100명 = 80%)
   - 미응답자 추적 (20명)
   ↓
[5단계] 추가 대화 및 조율
   - 배송일 변경: 직원이 친구톡으로 답장
   - 주소 변경: 시스템에서 정보 업데이트
   ↓
[6단계] 미응답자 재발송
   - 자동 또는 수동 재발송
   ↓
[7단계] 배송 처리
   - 확정된 정보로 배송 의뢰
   - 엑셀 다운로드

엔드포인트:
https://api-alimtalk.cloud.toast.com/alimtalk/v2.3/appkeys/{appkey}

인증 방식:
X-Secret-Key: {secret_key}

필요한 키:
NHN_ALIMTALK_APP_KEY=your_app_key
NHN_ALIMTALK_SECRET_KEY=your_secret_key
NHN_ALIMTALK_SENDER_KEY=your_sender_key

참고 문서:
https://docs.nhncloud.com/ko/Notification/KakaoTalk%20Bizmessage/ko/alimtalk-api-guide/

API 문서: 회원가입 후 다운로드 가능
- 메시지 발송 가이드
- API 연동 가이드
- DB Agent 연동 가이드

전략:
[1단계] 알림톡 (고정 템플릿)
   - 첫 메시지만 템플릿 사용
   - 채널 친구 추가 유도
   ↓
[2단계] 고객이 채널 친구 추가
   ↓
[3단계] 친구톡 (LLM 자동생성) ⭐
   - 이후 모든 대화는 LLM으로 생성
   - 고객별 맞춤 응답
   - 배송일 조율, 주소 확인 등 완전 자동화

메시지 내용:
안녕하세요 #{고객명}님,
이마트 #{점포명}입니다.

🎁 선물을 보내드립니다!

#{발신자명}님께서 #{상품명}을(를) 보내주셨습니다.

냉장 제품으로 직접 수령이 필요하여 배송지와 배송 날짜를 확인하고 있습니다.

📍 배송지: #{주소}
📦 배송 가능일: #{배송일자}

위 내용이 맞으시면 아래 버튼으로 채널 친구 추가 후 답장 부탁드립니다.

💬 채널 친구 추가 시:
- 배송 일정 조율 가능
- 주소 변경 요청 가능
- 실시간 문의 가능

감사합니다.

[버튼: 채널 추가하고 답장하기]

class MessagingService:
    def send_alimtalk(self, recipient, order):
        """첫 메시지: 알림톡 (고정 템플릿)"""
        response = partner_api.send_alimtalk(
            phone=recipient.phone,
            template_code='EMART_DELIVERY_001',
            variables={
                '고객명': recipient.name,
                '점포명': order.store_name,
                '발신자명': order.sender_name,
                '상품명': order.product_name,
                '주소': recipient.address,
                '배송일자': order.delivery_date
            }
        )
        return response
    
    def send_friendtalk(self, recipient, context):
        """이후 대화: 친구톡 (LLM 자동생성) ⭐"""
        # LLM으로 메시지 생성
        message = llm_service.generate_message(
            customer_name=recipient.name,
            conversation_history=context.history,
            current_situation=context.situation
        )
        
        # 친구톡 발송 (템플릿 불필요)
        response = partner_api.send_friendtalk(
            phone=recipient.phone,
            message=message
        )
        return response

• 알림톡 발송: 100건 × 12원 = 1,200원
• 고객 회신 수신: 80건 × 0원 = 0원
• 직원 답장: 80건 × 7원 = 560원
• 추가 대화: 20건 × 7원 = 140원
─────────────────────────────────
합계: 1,900원

• 초기 발송: 100건 × 12원 = 1,200원
• 1차 응답 처리: 80건 × 7원 = 560원
• 추가 조율 대화: 60건 × 7원 = 420원
• 미응답자 재발송: 20건 × 12원 = 240원
• 재발송 응답 처리: 30건 × 7원 = 210원
─────────────────────────────────
합계: 2,630원

• 초기 발송: 1,000건 × 12원 = 12,000원
• 1차 응답 처리: 800건 × 7원 = 5,600원
• 추가 조율 대화: 600건 × 7원 = 4,200원
• 미응답자 재발송: 200건 × 12원 = 2,400원
• 재발송 응답 처리: 300건 × 7원 = 2,100원
─────────────────────────────────
합계: 26,300원

Week 1: 파트너사 선정 및 계약 (2-3일)
  ├─ 업체 비교 및 선정
  ├─ 계약 체결
  └─ 계정 생성

Week 1-2: 발신 프로필 및 템플릿 등록 (2-4일)
  ├─ 발신 프로필 등록 (파트너사 대행)
  ├─ 템플릿 작성 및 등록
  └─ 심사 승인 대기

Week 2: 시스템 개발 (2-3일)
  ├─ Backend API 연동
  ├─ Frontend UI 개발
  └─ Webhook 구현

Week 2: 테스트 및 운영 준비 (1-2일)
  ├─ 단위/통합 테스트
  ├─ 직원 교육
  └─ 매뉴얼 작성

Week 3: 베타 테스트 (설날 명절)
  └─ 실제 업무 환경에서 검증

안녕하세요, 이마트입니다.

카카오톡 알림톡/친구톡 서비스 도입을 검토 중입니다.

[서비스 개요]
- 채널명: emart_giftcall
- 용도: 선물세트 배송 안내 및 고객 응답 수신
- 예상 발송량: 연 2,000-3,000건 (설날, 추석)

[필요 기능]
- 알림톡 발송 API
- 친구톡 양방향 대화
- Webhook을 통한 고객 회신 수신
- 발신 프로필 및 템플릿 등록 지원

[문의 사항]
- 계약 절차 및 소요 기간
- 발송 단가 (알림톡, 친구톡)
- API 문서 및 개발 가이드
- 기술 지원 범위

연락처: ████████████
담당자: ████