브랜드메시지 기본형의 콘텐츠 유형별 kmp_msg 테이블 등록 예시입니다.
사용 조건
아래 예시는 브랜드메시지 발송 모듈 3.2.0 이상 버전을 기준으로 합니다.
주의 사항
- 아래 값은 샘플입니다. 실제 환경에 맞게 수신번호, 발신번호, 발신 프로필 키, 템플릿 코드 및 이미지 URL 등을 변경하세요.
KKO_JSON과CAROUSEL컬럼에는 JSON 문자열이 입력됩니다.- 템플릿 등록 내용과 발송 데이터의 문구 및 구성 요소가 일치해야 합니다.
- 운영 적용 전 사용 중인 브랜드메시지 연동 규격에서 필수 필드와 허용값을 확인하세요.
| 유형 | KKO_CONTENT_TYPE |
주요 데이터 컬럼 |
|---|---|---|
| 텍스트 | BT |
MSG_BODY |
| 이미지 | BT |
MSG_BODY, KKO_JSON |
| 와이드 | BT |
MSG_BODY, KKO_JSON, WIDE |
| 와이드 아이템 리스트 | BL |
KKO_HEADER, KKO_JSON |
| 캐러셀 피드 | BC |
CAROUSEL |
| 커머스 | BM |
KKO_JSON, ADDITIONAL_CONTENT |
| 캐러셀 커머스 | BA |
CAROUSEL, KKO_JSON, ADDITIONAL_CONTENT |
| 항목 | 예시 값 | 설명 |
|---|---|---|
MSG_TYPE |
7 |
메시지 유형 |
CMID |
test0001 |
메시지 고유 식별자 |
DEST_PHONE |
01011112222 |
수신번호 |
SEND_PHONE |
0226264000 |
발신번호 |
SENDER_KEY |
채널별 키 | 카카오톡 채널 발신 프로필 키 |
TEMPLATE_CODE |
템플릿별 코드 | 등록된 브랜드메시지 템플릿 코드 |
NATION_CODE |
82 |
국가번호 |
ADULT |
Y 또는 N |
성인 콘텐츠 여부 |
PUSH_ALARM |
Y 또는 N |
푸시 알림 여부 |
TARGETING |
M, I 등 |
타기팅 구분값 |
WIDE |
Y 등 |
와이드 유형 여부 |
BTMSG_BODY에 입력합니다.INSERT INTO kmp_msg (
MSG_TYPE,
CMID,
REQUEST_TIME,
SEND_TIME,
DEST_PHONE,
SEND_PHONE,
MSG_BODY,
SENDER_KEY,
NATION_CODE,
ADULT,
PUSH_ALARM,
TEMPLATE_CODE,
TARGETING,
KKO_CONTENT_TYPE
)
VALUES (
7,
'test0001',
NOW(),
NOW(),
'01011112222',
'0226264000',
'브랜드 메시지 기본형(텍스트) 입니다.
변수',
'd6b73318d4927aa80df1022e07fecf06c55b44bf',
'82',
'Y',
'Y',
'4004914405d5bc824bb2a63863cc2fd2b3d56fa8',
'M',
'BT'
);
BTKKO_JSON에 입력합니다.INSERT INTO kmp_msg (
MSG_TYPE,
CMID,
REQUEST_TIME,
SEND_TIME,
DEST_PHONE,
SEND_PHONE,
MSG_BODY,
SENDER_KEY,
NATION_CODE,
ADULT,
PUSH_ALARM,
TEMPLATE_CODE,
KKO_JSON,
TARGETING,
KKO_CONTENT_TYPE
)
VALUES (
7,
'test0002',
NOW(),
NOW(),
'01011112222',
'0226264000',
'공백 포함 최대 400자(줄바꿈 최대 29개). 변수는 #{변수명} 규칙(최대 20자 이내 한글, 영문, 숫자, -, _)으로 작성 가능',
'd6b73318d4927aa80df1022e07fecf06c55b44bf',
'82',
'N',
'Y',
'b727a552b708716605852e0fdf5f4b8548cabea2',
'{
"image": {
"img_url": "https://mudkage.kakao.com/dn/qpqUa/btsPWgFDeDs/NXz3WTZtud2e9Fc7PKMQKk/img_l.jpg"
},
"coupon": {
"title": "800원 할인 쿠폰"
}
}',
'I',
'BT'
);
BTWIDE에 Y를 입력합니다.KKO_JSON에 입력합니다.INSERT INTO kmp_msg (
MSG_TYPE,
CMID,
REQUEST_TIME,
SEND_TIME,
DEST_PHONE,
SEND_PHONE,
MSG_BODY,
SENDER_KEY,
NATION_CODE,
ADULT,
PUSH_ALARM,
TEMPLATE_CODE,
KKO_JSON,
TARGETING,
WIDE,
KKO_CONTENT_TYPE
)
VALUES (
7,
'test0003',
NOW(),
NOW(),
'01011112222',
'0226264000',
'브랜드 메시지 템플릿 와이드',
'd6b73318d4927aa80df1022e07fecf06c55b44bf',
'82',
'N',
'Y',
'5a8f96e43d48965d847399537a080f94c549bc63',
'{
"image": {
"img_url": "https://mudkage.kakao.com/dn/8hcaJ/btsP6I8Y6Az/JjkZKpeFjliwt3c6v0ORZ1/img_l.jpg"
},
"button": [
{
"type": "WL",
"url_pc": "https://business.kakao.com/info/bizmessage/",
"url_mobile": "https://business.kakao.com/info/bizmessage/"
}
]
}',
'M',
'Y',
'BT'
);
BLKKO_HEADER에 입력합니다.MSG_BODY와 KKO_JSON을 NULL로 설정합니다.INSERT INTO kmp_msg (
MSG_TYPE,
CMID,
REQUEST_TIME,
SEND_TIME,
DEST_PHONE,
SEND_PHONE,
MSG_BODY,
SENDER_KEY,
NATION_CODE,
ADULT,
PUSH_ALARM,
TEMPLATE_CODE,
KKO_JSON,
TARGETING,
WIDE,
KKO_CONTENT_TYPE,
KKO_HEADER
)
VALUES (
7,
'test0004',
NOW(),
NOW(),
'01011112222',
'0226264000',
NULL,
'd6b73318d4927aa80df1022e07fecf06c55b44bf',
'82',
'N',
'Y',
'1f0ce5806f49a31528fdd25b51578a3250d95916',
NULL,
'M',
'',
'BL',
'헤더입니다.'
);
BCCAROUSEL에 입력합니다.INSERT INTO kmp_msg (
MSG_TYPE,
CMID,
REQUEST_TIME,
SEND_TIME,
DEST_PHONE,
SEND_PHONE,
MSG_BODY,
SENDER_KEY,
TEMPLATE_CODE,
NATION_CODE,
RE_TYPE,
RE_BODY,
AD_FLAG,
CAROUSEL,
KKO_CONTENT_TYPE,
TARGETING
)
VALUES (
7,
'test0005',
NOW(),
NOW(),
'01011112222',
'0226264000',
NULL,
'd6b73318d4927aa80df1022e07fecf06c55b44bf',
'55e0371ec33cbb03cb98df1ceb7b2de1f79b5815',
'82',
'N',
'',
'Y',
'{
"list": [
{
"header": "헤더",
"message": "공백 포함 최대 180자(줄바꿈 최대 2개). 변수는 변수명 규칙(최대 20자 이내 한글, 영문, 숫자, -, *)으로 작성 가능",
"attachment": {
"image": {
"img_url": "https://mudkage.kakao.com/dn/Sjf0H/btsPXqgC7nH/GGyjwQhdSXKn4VtQ5zxoRK/img_l.jpg",
"img_link": "https://business.kakao.com/info/bizmessage/"
}
}
},
{
"header": "헤더값",
"message": "공백 포함 최대 180자(줄바꿈 최대 2개). 변수는 변수명 규칙(최대 20자 이내 한글, 영문, 숫자, -, *)으로 작성 가능",
"attachment": {
"image": {
"img_url": "https://mudkage.kakao.com/dn/Sjf0H/btsPXqgC7nH/GGyjwQhdSXKn4VtQ5zxoRK/img_l.jpg",
"img_link": "https://business.kakao.com/info/bizmessage/"
}
}
}
]
}',
'BC',
'M'
);
BMKKO_JSON에 입력합니다.ADDITIONAL_CONTENT를 NULL로 설정합니다.INSERT INTO kmp_msg (
MSG_TYPE,
CMID,
REQUEST_TIME,
SEND_TIME,
DEST_PHONE,
SEND_PHONE,
MSG_BODY,
SENDER_KEY,
TEMPLATE_CODE,
NATION_CODE,
RE_TYPE,
RE_BODY,
AD_FLAG,
CAROUSEL,
KKO_JSON,
KKO_CONTENT_TYPE,
TARGETING,
ADDITIONAL_CONTENT
)
VALUES (
7,
'test0006',
NOW(),
NOW(),
'01011112222',
'0226264000',
NULL,
'd6b73318d4927aa80df1022e07fecf06c55b44bf',
'ee1e569bfb88149e0d139935800e1ce6b9e34119',
'82',
'N',
'',
'Y',
'',
'{
"image": {
"img_url": "https://mudkage.kakao.com/dn/qA3ch/btsPWeuhsNl/AzPlNK13zsfU8KBxDLGQW1/img_l.jpg"
}
}',
'BM',
'M',
NULL
);
BACAROUSEL에 입력합니다.KKO_JSON과 ADDITIONAL_CONTENT를 빈 문자열로 설정합니다.INSERT INTO kmp_msg (
MSG_TYPE,
CMID,
REQUEST_TIME,
SEND_TIME,
DEST_PHONE,
SEND_PHONE,
MSG_BODY,
SENDER_KEY,
TEMPLATE_CODE,
NATION_CODE,
RE_TYPE,
RE_BODY,
AD_FLAG,
CAROUSEL,
KKO_JSON,
KKO_CONTENT_TYPE,
TARGETING,
ADDITIONAL_CONTENT
)
VALUES (
7,
'test0008',
NOW(),
NOW(),
'01011112222',
'0226264000',
NULL,
'd6b73318d4927aa80df1022e07fecf06c55b44bf',
'e4a70ed42c95748ed22382e5994d784cb52141d6',
'82',
'N',
'',
'Y',
'{
"head": {
"image_url": "https://mudkage.kakao.com/dn/qA3ch/btsPWeuhsNl/AzPlNK13zsfU8KBxDLGQW1/img_l.jpg"
},
"list": [
{
"attachment": {
"image": {
"img_url": "https://mudkage.kakao.com/dn/Sjf0H/btsPXqgC7nH/GGyjwQhdSXKn4VtQ5zxoRK/img_l.jpg",
"img_link": "https://business.kakao.com/info/bizmessage/"
}
}
},
{
"attachment": {
"image": {
"img_url": "https://mudkage.kakao.com/dn/Sjf0H/btsPXqgC7nH/GGyjwQhdSXKn4VtQ5zxoRK/img_l.jpg",
"img_link": "https://business.kakao.com/info/bizmessage/"
}
}
},
{
"attachment": {
"image": {
"img_url": "https://mudkage.kakao.com/dn/Sjf0H/btsPXqgC7nH/GGyjwQhdSXKn4VtQ5zxoRK/img_l.jpg",
"img_link": "https://business.kakao.com/info/bizmessage/"
}
}
}
]
}',
'',
'BA',
'M',
''
);
CMID가 발송 건마다 고유한 값인지 확인합니다.SENDER_KEY가 사용할 카카오톡 채널의 발신 프로필 키인지 확인합니다.TEMPLATE_CODE가 승인된 브랜드메시지 템플릿 코드인지 확인합니다.MSG_BODY, KKO_JSON, CAROUSEL의 구성 요소가 일치하는지 확인합니다.TARGETING, ADULT, PUSH_ALARM, AD_FLAG, WIDE의 허용값을 연동 규격에서 확인합니다.