docs:카카오톡 개발문서에 전자계약 알림톡 연동 계획 추가

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
김보곤
2026-02-14 15:41:05 +09:00
parent 579965ed5c
commit 9ea83b8b7d

View File

@@ -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 | 초안 작성 - 코드 구현 완료, 실 서비스 연동 대기 |