Overview
Overview
2025-12-31 업데이트 된 contents_type 변경 사항에 대해 설명하는 문서입니다.
신규 타입인 template, 기존 타입 normal에 대한 변경 사항을 설명 합니다.
참고 사항
normal 메시지
기존에 상담사 메시지로 발송되던 normal 메시지도 template 타입으로 발화됩니다.
또한 normal 타입 메시지에 경우 카카오 상담톡에 한해 보안 메시지가 제공됩니다.
보안 메시지 (isLocked)
보안 메시지에 경우 카카오 상담톡에서만 지원됩니다.
이외 채널에서는 일괄 false로 처리됩니다.
normal 타입 추가 사항
보안 메시지
보안 메시지 설명
카카오 상담톡에서 보안 메시지로 발송할 수 있는 기능이며, 채팅v2에서 상담사가 보안 메시지를 활성화 하여 발화 하면 "발송 케이스"에 따라 보안 메시지로 변환되어 발송됩니다.
발송 케이스
발송 케이스 상세
단일 텍스트
입력창에 텍스트만 입력하여 발송할 경우 기존 text 타입에서 normal 타입으로 변경되며 isLocked 필드에 정의된 값이 true로 전달됩니다.
데이터 포맷
데이터 포맷 예시
단일 텍스트
{
"text": "단일 텍스트 보안 메시지 설정 데이터 예시",
"image_url": "",
"link":
{
"name":
[],
"url":
[]
},
"isLocked": true
}
JavaScript
복사
데이터 포맷 필드별 설정
메시지 포맷
Link
필드명 | 데이터 타입 | 필수여부 | 설명 |
text | text (1000) | Y | 메시지 문구 |
image_url | text(1000) | N | 이미지 링크 (보안 메시지에서는 미지원) |
link | Link | N | 링크 버튼 |
isLocked | Boolean | Y | 보안메시지 발화 여부 (default : false) |
template 타입 정의
TEXT
IMAGE
CAROUSEL
TEXT 타입 설명
텍스트를 기준으로 구성된 혼합형 메시지 입니다.
메시지 구성 형태
•
텍스트 + 버튼
•
텍스트 + 바로 연결 버튼
•
텍스트 + 버튼 + 바로 연결 버튼
데이터 포맷
TEXT 타입 데이터 포맷
{
"type": "TEXT",
"message": "텍스트 + 버튼 + 바로연결",
"buttonList": [
{
"type": "TEXT",
"name": "챗봇 발화 버튼"
},
{
"type": "WEB_LINK",
"name": "링크 버튼",
"pcUrl": "https://www.naver.com",
"mobileUrl": "https://m.naver.com"
},
{
"type": "COUPON",
"name": "쿠폰",
"description": "쿠폰 테스트",
"pcUrl": "https://www.naver.com",
"mobileUrl": "https://m.naver.com",
"schemaAOS": "https://www.naver.com",
"schemaIOS": "https://www.naver.com"
}
],
"quickReplyList": [
{
"type": "TEXT",
"name": "챗봇 발화 버튼"
},
{
"type": "WEB_LINK",
"name": "링크 버튼",
"pcUrl": "https://www.naver.com",
"mobileUrl": "https://m.naver.com"
}
],
"isLocked": false
}
JavaScript
복사
필드 정의
필드명 | 데이터 타입 | 필수여부 | 설명 |
type | Type | Y | 템플릿 메시지 타입 |
message | text (1000) | Y | 메시지 문구 |
buttonList | Button[] | N | 메시지 버튼 |
quickReplyList | QuickReply[] | N | 바로 연결 버튼 |
isLocked | Boolean | Y | 보안메시지 발화 여부 (default : false) |
Data Dictionary
Type
Button
ButtonType
QuickReply
QuickReplyType
Image
Carousel
Coupon
타입명 | 설명 |
TEXT | 텍스트 메시지와 버튼, 바로연결 등 혼합형 메시지를 발화하는 타입 |
IMAGE | 이미지 + 텍스트 메시지와 버튼, 바로연결 등 혼합형 메시지를 발화하는 타입 |
CAROUSEL | 별도의 필드에 메시지를 정의하여 블록을 슬라이드 형태로 보여줄 수 있는 타입 |


