moon
sun

메시지 포맷 · 템플릿/잠금

📒 HappyTalk Developer Center / 메시지 포맷
메뉴
공지사항
메시지 포맷
Biz API
해피톡
카카오 상담톡 웹훅
Open API
채팅 버튼 연동 (SDK)
목차

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
복사

데이터 포맷 필드별 설정

필드명
데이터 타입
필수여부
설명
text
text (1000)
Y
메시지 문구
image_url
text(1000)
N
이미지 링크 (보안 메시지에서는 미지원)
link
Link
N
링크 버튼
isLocked
Boolean
Y
보안메시지 발화 여부 (default : false)

template 타입 정의

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

타입명
설명
TEXT
텍스트 메시지와 버튼, 바로연결 등 혼합형 메시지를 발화하는 타입
IMAGE
이미지 + 텍스트 메시지와 버튼, 바로연결 등 혼합형 메시지를 발화하는 타입
CAROUSEL
별도의 필드에 메시지를 정의하여 블록을 슬라이드 형태로 보여줄 수 있는 타입