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