🚨 템플릿 타입 전환 안내
해피톡 템플릿 업데이트에 따라 OPEN API에서도 템플릿 메시지 관련 구조 및 타입이 개선되었습니다.
서비스 이용에 차질이 없도록, 아래 내용을 참고하시어 정해진 일정 내에 대응 개발 검토 및 적용 부탁드립니다.
✅ 적용 일정
- 전체 서비스 반영: 2025년 12월 9일
- 대응 필요 일정: 2026년 6월 30일
Warning
2026년 7월 1일 대응 개발 여부와 상관없이 템플릿 V1 정책을 종료할 예정이며, 안정적인 서비스 이용을 위해 조기 대응을 권장드립니다.
🔧 적용 대상
다음 조건에 해당하는 업체로, 해당 업체는 템플릿 V1 정책이 적용됩니다. 해당 업체는 반드시 템플릿 V2 정책에 맞게 대응 개발이 필요하며, 대응 필요 일정까지 완료되지 않을 시 정상적으로 템플릿 메시지가 조회되지 않으니 필히 대응을 진행해주시길 바랍니다.
- Biz API 사용 업체
- 아카이브 사용 업체
- 상담 내역 조회 API 사용 업체
- Happytalk Embedded 사용 업체
| 대상 | 적용 정책 | 설명 |
|---|---|---|
| 템플릿 V1 업체 | 기존 정책 (대응 필요) | 신규 템플릿 기능이 비활성화되며, 기존 normal 타입이 사용됩니다. |
| 템플릿 V2 업체 | 신규 템플릿 정책 적용 | 신규 템플릿 기능이 활성화되며, contents_type: template 타입이 사용됩니다. |
Info
자세한 내용은 새로운 메시지 포맷 가이드에서 확인하실 수 있습니다.
📊 주요 변경 사항
| 항목 | 변경 전 | 변경 후 | 비고 |
|---|---|---|---|
템플릿 메시지 발송 시 contents_type |
normal |
template |
V2 업체 대상 모든 템플릿 메시지 공통 적용 |
🎯 대상 기능 및 주요 변경 내역
1️⃣ biz-api
대상
주요 변경 사항
- 템플릿 메시지 타입 분리
contents_type필드template타입 추가
2️⃣ 상담 내역 조회 API
대상
주요 변경 사항
- 템플릿 메시지 타입 분리
contents_type필드template타입 추가
- 카카오 상담톡 보안 메시지 추가
isLocked필드 추가
3️⃣ 아카이브
대상
주요 변경 사항
- 템플릿 메시지 타입 분리
contents_type필드template타입 추가
- 카카오 상담톡 보안 메시지 추가
isLocked필드 추가
❗ 유의사항
-
신규
template타입은 기존normal타입과 구조가 다릅니다. -
기존 응답 파싱 로직 또는 필터 조건을 사용하는 경우, 반드시 신규 타입(
template)에 대한 처리 로직을 추가해 주세요. -
contents_type값이 누락되거나 구버전 필드를 사용할 경우, 일부 데이터 수집/표기 오류가 발생할 수 있습니다. -
V1 업체는 안정적인 서비스 이용을 위해 조기 대응을 권장드립니다.