diff --git a/features/barobill-kakaotalk/README.md b/features/barobill-kakaotalk/README.md index 846c63d..96a4771 100644 --- a/features/barobill-kakaotalk/README.md +++ b/features/barobill-kakaotalk/README.md @@ -237,7 +237,77 @@ KakaotalkButton --- -## 8. 참고 자료 +## 8. 활용 계획: 전자계약(E-Sign) 알림톡 연동 + +### 8.1 배경 + +현재 전자계약은 **이메일**로 발송하고 있으나, 열람률이 낮고 확인이 지연되는 문제가 있다. +카카오톡 알림톡으로 전환하면 즉시 알림이 도달하여 계약 체결 속도를 크게 개선할 수 있다. + +### 8.2 발송 흐름 + +``` +전자계약 생성 (E-Sign) + │ + ├─ [기존] 이메일 발송 + │ + └─ [추가] 알림톡 발송 (SendATKakaotalkEx) + │ + ├─ 메시지: "{회사명}에서 전자계약서가 도착했습니다." + ├─ 내용: 계약명, 발신자, 마감일 등 + └─ 버튼: [계약서 확인하기] → 전자서명 페이지 URL + (ButtonType: WL, 웹링크) +``` + +### 8.3 알림톡 템플릿 (안) + +``` +[전자계약 도착 안내] + +안녕하세요, #{수신자명}님. +#{발신회사명}에서 전자계약서가 도착했습니다. + +■ 계약명: #{계약명} +■ 발신자: #{발신자명} +■ 마감일: #{마감일} + +아래 버튼을 눌러 계약서를 확인하고 서명해주세요. + +[계약서 확인하기] ← 웹링크 버튼 +``` + +> 카카오 템플릿 검수 시 정보성 메시지로 분류되어 승인 가능성 높음 + +### 8.4 기술 구현 포인트 + +| 항목 | 내용 | +|------|------| +| **사용 API** | `SendATKakaotalkEx` (버튼 포함 알림톡) | +| **버튼 타입** | `WL` (웹링크) - 모바일/PC URL 모두 설정 | +| **SMS 대체발송** | 카카오톡 미사용자에게 자동 SMS 전환 | +| **구현 위치** | 전자계약 발송 컨트롤러에서 `BarobillService::sendATKakaotalkEx()` 호출 추가 | +| **이메일 병행** | 알림톡 + 이메일 동시 발송 (선택 가능하게) | + +### 8.5 기대 효과 + +- **열람률 향상**: 이메일(20~30%) → 카카오톡(80%+) +- **체결 속도**: 이메일 확인 지연(수시간~1일) → 카카오톡 즉시 확인 +- **접근성**: 별도 앱 설치 없이 카카오톡에서 바로 계약서 페이지 이동 +- **미사용자 대응**: SMS 대체발송으로 카카오톡 미사용자도 커버 + +### 8.6 준비 순서 + +| 순서 | 내용 | 비고 | +|------|------|------| +| 1 | 카카오 채널 개설 | 법인 명의 휴대폰 필요 | +| 2 | 바로빌에 채널 연동 | 바로빌 관리 페이지 | +| 3 | "전자계약 도착 안내" 템플릿 등록 | 카카오 검수 1~3 영업일 | +| 4 | 전자계약 컨트롤러에 알림톡 발송 로직 추가 | 코드 구현 | +| 5 | 테스트 발송 → 운영 전환 | testws → ws | + +--- + +## 9. 참고 자료 - [바로빌 API 문서](https://dev.barobill.co.kr) - [카카오비즈니스 채널 관리](https://business.kakao.com) @@ -249,4 +319,5 @@ KakaotalkButton | 날짜 | 버전 | 변경 내용 | |------|------|----------| +| 2026-02-14 | 0.2 | 전자계약(E-Sign) 알림톡 연동 활용 계획 추가 | | 2026-02-14 | 0.1 | 초안 작성 - 코드 구현 완료, 실 서비스 연동 대기 |