본문 바로가기 메뉴 바로가기

Kakao i Connect Message::BizMessage(KOR)::Agent 설치 방식::브랜드 메세지 발송

페이지 이동경로

브랜드 메세지 발송

브랜드 메세지(구. 친구톡 업그레이드)는 기존 친구톡의 업그레이드된 버전입니다. 기존 친구톡은 2025.12.31일 서비스 종료 예정이며, 브랜드메시지 서비스로 전환될 예정입니다. 광고주가 마케팅수신동의자(이하. 마수동)에게 발송을 위해서는 발신프로필 단위로 발송 권한을 획득해야하며, 무료수신거부 전화번호가 등록되어야 합니다. 브랜드 메시지에는 크게 두가지 기능이 추가되었습니다.

기본형(템플릿 등록 후 발송하는 형태) 발송하기

  • 기존 알림톡처럼 템플릿을 등록 후 발송하는 형태입니다. 알림톡 템플릿은 검수 승인 후 발송할 수 있으나, 브랜드 메시지 템플릿은 승인 절차가 없습니다. 따라서, 브랜드 메시지 템플릿 등록 이후 즉시 발송할 수 있습니다.
  • 알림톡 템플릿으로 브랜드 메시지를 발송할 수 없습니다.(반대의 경우도 미지원)
  • 브랜드메시지 템플릿 관리 API 개발 문서를 참고하여 등록 / 조회 / 수정 / 삭제 할 수 있습니다.

브랜드 메시지 타게팅

  • 타게팅은 기본형(템플릿 등록 후 발송) 타입만 지원합니다
  • 기존 친구톡은 채널추가된 친구에게만 발송할 수 있었습니다. 수신자가 채널 미추가시 3018(NoSendAvailableException) 실패됩니다.
  • 브랜드 메시지는 광고주가 마수동을 받은 경우 채널 추가하지 않은 사용자에게도 발송할 수 있습니다.
  • targeting 은 M, N, I, F로 구분됩니다. (하단 이미지 참고, 기존 친구톡은 ‘I’와 동일)

표브랜드메시지 타입별 발송 조건
타겟 발송조건 비고
M 1. 비즈니스 인증 채널
2. 사업자 번호 등록
- 채널관리자센터 > 관리 > 비즈니스 채널 신청 > 사업자정보 등록
- https://center-pf.kakao.com/profiles
3. 채널 고객센터 전화번호 등록
4. 채널 친구수 5만 이상
5. 3개월 내 알림톡 발송 성공 이력 보유
**6~7번 API 제공 안내 예정
6. 채널에 080 무료수신거부 전화번호 등록
7. 광고주(고객사) 마케팅 수신 동의 화면 증적 파일 		-마수동 회원 대상 발송
N
I 비즈니스 인증 필요 -채널 친구
F
표브랜드 메시지 타게팅
구분 설명 마수동 발송 가능
U_FT 브랜드 메시지 텍스트 O
U_FI 브랜드 메시지 이미지 O
U_FW 브랜드 메시지 와이드 이미지 O
U_FA 브랜드 메시지 캐러셀 커머스 O
U_FP 브랜드 메시지 프리미엄 동영상 O
U_FC 브랜드 메시지 캐러셀 피드 O
U_FL 브랜드 메시지 와이드 리스트 O
U_FM 브랜드 메시지 커머스 O

주의 사항 안내

  • 브랜드메시지 설명 별도 가이드, 장표 참고

  • 등록된 템플릿과 내용이 상이할 경우 발송 실패되므로, 사전에 등록된 내용과 동일하게 발송해야 합니다. 따라서 운영 발송전 해당 템플릿이 정상 발송되는지 확인(테스트)이 필요합니다.

  • 발송 가능 시간 : 08:00 ~ 20:50분

  • 브랜드메시지 템플릿은 승인 절차 없이 등록 후 바로 발송 가능 합니다.

  • 브랜드메시지 발송 요청 SQL 작성시 객체 정보 참고하여 작성
    ㄴ [참고] 브랜드메시지 객체 설명

코드예제BM(브랜드메시지) 자유형 텍스트 타입 발송 

INSERT INTO BM_MESSAGE (
    UPGRADE_TP
  , MSG_TYPE
  , MOBILE_NO
  , SENDER_NO
  , MESSAGE
  , BUTTON
  , FALL_BACK_YN
)
VALUES(
    'FY' 		    ##UPGRADE_TP
  , 'U_FT' 		    ##MSG_TYPE
  , '[수신번호]' 	##MOBILE_NO
  , '[발신번호]' 	##SENDER_NO
  , '친구톡 FY TYPE 발송 테스트'
  , '[
    {"name":"앱링크버튼","type":"AL","scheme_android":"https://kakao.com", "scheme_ios":"https://kakao.com","url_mobile":"https://kakao.com"},
    {"name":"웹링크버튼","type":"WL","url_mobile":"http://kakao.com"}
]'
  , false 		##FALL_BACK_YN
);

코드예제BM(브랜드메시지) 자유형 텍스트 쿠폰 타입 발송 

INSERT INTO BM_MESSAGE (
    UPGRADE_TP
  , MSG_TYPE
  , TARGET
  , MOBILE_NO
  , SENDER_NO
  , FALL_BACK_YN
  , MESSAGE
  , BUTTON
  , COUPON
)
VALUES (
    'FY'                ##UPGRADE_TP
  , 'U_FT'             ##MSG_TYPE
  , 'I'             ##TARGET
  , '[수신번호]'     ##MOBILE_NO
  , '[발번호]'      ##SENDER_NO
  ,  0              ##FALL_BACK_YN
  ,  '브랜드메시지 메시지본문 발송 TEST \n 자유형 \n 텍스트'
  ,  '[
{
"name": "버튼1",
"type": "WL",
"url_mobile": "https://daum.net/test1",
"url_pc": "https://daum.net/test2"
},
{
"name": "봇키워드",
"type": "BK"
},
{
"name": "메시지전달",
"type": "MD"
},
{
"name": "웹링크",
"type": "WL",
"url_mobile": "https://daum.net/test3",
"url_pc": "https://daum.net/test4"
}
]'
  ,  '{                               ##COUPON
"title": "10% 할인 쿠폰",
"description": "쿠폰할인",
"url_mobile": "http://daum.net"
}'
);

코드예제BM(브랜드메시지) 자유형 이미지, 와이드 이미지 타입 발송 

INSERT INTO BM_MESSAGE
(
    UPGRADE_TP
  , MSG_TYPE
  , MOBILE_NO
  , SENDER_NO
  , MESSAGE
  , BUTTON
  , FALL_BACK_YN
  , IMAGE
)
VALUES (
    'FY'            ##UPGRADE_TP
  , 'U_FI'         ##MSG_TYPE
  , '[수신번호]'    ##MOBILE_NO
  , '[발번호]'      ##SENDER_NO
  ,  '친구톡 FI TYPE 발송 테스트' ##MESSAGE
  , '[                            ##BUTTON
    {"name":"앱링크버튼","type":"AL","scheme_android":"https://kakao.com", "scheme_ios":"https://kakao.com","url_mobile":"https://kakao.com"},
    {"name":"웹링크버튼","type":"WL","url_mobile":"http://kakao.com"}
    ]'
   , false         ##FALL_BACK_YN
   , '{"img_url":"https://mud-kage.kakao.com/dn/cLC43q/btsOqJW0D7E/AfmDO2U8SL2Sd0Kgm9h2k0/img_l.jpg", "img_link":"https://google.com"}'
);

코드예제BM(브랜드메시지) 자유형 와이드 리스트 타입 발송 

 INSERT INTO BM_MESSAGE(
    UPGRADE_TP
  , MSG_TYPE
  , MOBILE_NO
  , SENDER_NO
  , MESSAGE
  , BUTTON
  , FALL_BACK_YN
  , ITEM
  , HEADER
 )
 VALUES (
    'FY'                 ##UPGRADE_TP
  , 'U_FL'              ##MSG_TYPE
  , '[수신번호]'         ##MOBILE_NO
  , '[발신번호]'           ##SENDER_NO
   ,  '친구톡 Upgrade FL 와이드 리스트'
  , '[			##BUTTON
{"name":"앱링크버튼","type":"AL","scheme_android":"https://kakao.com", "scheme_ios":"https://kakao.com","url_mobile":"https://kakao.com"},
{"name":"웹링크버튼","type":"WL","url_mobile":"http://kakao.com"}
]'
  ,  false                      ##FALL_BACK_YN
  ,  '[		##ITEM
    {"title":"제목1","img_url":"https://mud-kage.kakao.com/dn/c0In8v/btsHt1XNqdN/H7Ee9ajYyFN2oRnEYKLXnk/img_l.jpg", "scheme_android": "https://kakao.com","scheme_ios":"https://kakao.com", "url_mobile":"https://kakao.com","url_pc":"https://kakao.com"}
    ,{"title":"제목2","img_url":"https://mud-kage.kakao.com/dn/c0In8v/btsHt1XNqdN/H7Ee9ajYyFN2oRnEYKLXnk/img_l.jpg", "scheme_android": "https://kakao.com","scheme_ios":"https://kakao.com", "url_mobile":"https://kakao.com", "url_pc":"https://kakao.com"}
    ,{"title":"제목3", "img_url":"https://mud-kage.kakao.com/dn/c0In8v/btsHt1XNqdN/H7Ee9ajYyFN2oRnEYKLXnk/img_l.jpg" ,"scheme_android": "https://kakao.com","scheme_ios":"https://kakao.com","url_mobile":"https://kakao.com", "url_pc":"https://kakao.com"}
    ]'
  ,  'TEST'	##HEADER
);

코드예제BM(브랜드메시지) 자유형 캐러셀 피드 타입 발송 

 INSERT INTO BM_MESSAGE (
    UPGRADE_TP
  , MSG_TYPE
  , MOBILE_NO
  , SENDER_NO
  , FALL_BACK_YN
  , CAROUSEL
 )
 VALUES (
    'FY'           ##UPGRADE_TP
  , 'U_FC'.       ##MSG_TYPE
  , '[수신번호]'    ##MOBILE_NO
  , '[발신번호]'    ##SENDER_NO
  ,  false        ##FALL_BACK_YN
  ,  '{
"list": [
{
"header": "1번 캐러셀 피드 헤더",
"message": "1번 캐러셀 피드 메시지",
"attachment": {
"image": {
"img_url": "https://mud-kage.kakao.com/dn/c0In8v/btsHt1XNqdN/H7Ee9ajYyFN2oRnEYKLXnk/img_l.jpg",
"img_link": "http://bizmessage.kakao.com/"
},
"button": [
{
"name": "버튼1",
"type": "WL",
"url_pc": "https://m.daum.net",
"url_mobile": "https://m.daum.net",
"scheme_ios": "",
"scheme_android": ""
},
{
"name": "버튼2",
"type": "WL",
"url_pc": "https://m.daum.net",
"url_mobile": "https://m.daum.net",
"scheme_ios": "",
"scheme_android": ""
}
],
"coupon": {
"title": "10000원 할인 쿠폰",
"description": "신년맞이 할인쿠폰",
"url_mobile": "https://daum.net",
"url_pc": "https://daum.net"
}
}
},
{
"header": "2번 캐러셀 피드 헤더",
"message": "2번 캐러셀 피드 메시지",
"attachment": {
"image": {
"img_url": "https://mud-kage.kakao.com/dn/c0In8v/btsHt1XNqdN/H7Ee9ajYyFN2oRnEYKLXnk/img_l.jpg",
"img_link": "http://bizmessage.kakao.com/"
},
"button": [
{
"name": "버튼1",
"type": "WL",
"url_pc": "https://m.daum.net",
"url_mobile": "https://m.daum.net",
"scheme_ios": "",
"scheme_android": ""
},
{
"name": "버튼2",
"type": "WL",
"url_pc": "https://m.daum.net",
"url_mobile": "https://m.daum.net",
"scheme_ios": "",
"scheme_android": ""
}
],
"coupon": {
"title": "777원 할인 쿠폰",
"description": "신년맞이 할인쿠폰",
"url_mobile": "https://daum.net",
"url_pc": "https://daum.net"
}
}
},
{
"header": "3번 캐러셀 피드 헤더",
"message": "3번 캐러셀 피드 메시지",
"attachment": {
"image": {
"img_url": "https://mud-kage.kakao.com/dn/c0In8v/btsHt1XNqdN/H7Ee9ajYyFN2oRnEYKLXnk/img_l.jpg",
"img_link": "http://bizmessage.kakao.com/"
},
"button": [
{
"name": "버튼1",
"type": "WL",
"url_pc": "https://m.daum.net",
"url_mobile": "https://m.daum.net",
"scheme_ios": "",
"scheme_android": ""
},
{
"name": "버튼2",
"type": "WL",
"url_pc": "https://m.daum.net",
"url_mobile": "https://m.daum.net",
"scheme_ios": "",
"scheme_android": ""
}
]
}
},
{
"header": "4번 캐러셀 피드 헤더",
"message": "4번 캐러셀 피드 메시지",
"attachment": {
"image": {
"img_url": "https://mud-kage.kakao.com/dn/c0In8v/btsHt1XNqdN/H7Ee9ajYyFN2oRnEYKLXnk/img_l.jpg",
"img_link": "http://bizmessage.kakao.com/"
},
"button": [
{
"name": "버튼1",
"type": "WL",
"url_pc": "https://m.daum.net",
"url_mobile": "https://m.daum.net",
"scheme_ios": "",
"scheme_android": ""
},
{
"name": "버튼2",
"type": "WL",
"url_pc": "https://m.daum.net",
"url_mobile": "https://m.daum.net",
"scheme_ios": "",
"scheme_android": ""
}
]
}
},
{
"header": "5번 캐러셀 피드 헤더",
"message": "5번 캐러셀 피드 메시지",
"attachment": {
"image": {
"img_url": "https://mud-kage.kakao.com/dn/c0In8v/btsHt1XNqdN/H7Ee9ajYyFN2oRnEYKLXnk/img_l.jpg",
"img_link": "http://bizmessage.kakao.com/"
},
"button": [
{
"name": "버튼1",
"type": "WL",
"url_pc": "https://m.daum.net",
"url_mobile": "https://m.daum.net",
"scheme_ios": "",
"scheme_android": ""
},
{
"name": "버튼2",
"type": "WL",
"url_pc": "https://m.daum.net",
"url_mobile": "https://m.daum.net",
"scheme_ios": "",
"scheme_android": ""
}
]
}
},
{
"header": "6번 캐러셀 피드 헤더",
"message": "6번 캐러셀 피드 메시지",
"attachment": {
"image": {
"img_url": "https://mud-kage.kakao.com/dn/c0In8v/btsHt1XNqdN/H7Ee9ajYyFN2oRnEYKLXnk/img_l.jpg",
"img_link": "http://bizmessage.kakao.com/"
},
"button": [
{
"name": "버튼1",
"type": "WL",
"url_pc": "https://m.daum.net",
"url_mobile": "https://m.daum.net",
"scheme_ios": "",
"scheme_android": ""
}
]
}
}
],
"tail": {
"url_pc": "https://m.daum.net",
"url_mobile": "https://m.daum.net",
"scheme_ios": "",
"scheme_android": ""}
}'
);

코드예제BM(브랜드메시지) 자유형 프리미엄동영상 타입 발송 

INSERT INTO BM_MESSAGE
(
    UPGRADE_TP
  , MSG_TYPE
  , MOBILE_NO
  , SENDER_NO
  , MESSAGE
  , BUTTON
  , FALL_BACK_YN
  , VIDEO
  , HEADER
)
VALUES (
    'FY'         ##UPGRADE_TP
  , 'U_FP'      ##MSG_TYPE
  , '[수신번호]' ##MOBILE_NO
  , '[발신번호]' ##SENDER_NO
  ,  '친구톡 Upgrade 프리미엄 동영상'
  , '[
{"name":"앱링크버튼","type":"AL","scheme_android":"https://kakao.com", "scheme_ios":"https://kakao.com","url_mobile":"https://kakao.com"}
]'
  ,  false ##FALL_BACK_YN
  , {"video_url":"https://tv.kakao.com/channel/4121367/cliplink/436972133?metaObjectType=Channel", "thumbnail_url":"http://img1.daumcdn.net/kakaotv/warhol/assets/kakao_ipbm/f26d3c901df683cd443c07a3e5ee9bedae4b8340"}'
  , 'HEADER'
);

코드예제BM(브랜드메시지) 자유형 커머스 타입 발송 

INSERT INTO BM_MESSAGE
(
    UPGRADE_TP
  , MSG_TYPE
  , MOBILE_NO
  , SENDER_NO
  , BUTTON
  , FALL_BACK_YN
  , IMAGE
  , ADD_CONTENT
  , COMMERCE
)
VALUES(
    'FY'           ##UPGRADE_TP
  , 'U_FM'        ##MSG_TYPE
  , '[수신번호]'  ##MOBILE_NO
  , '[발신번호]'  ##SENDER_NO
  , '[            ##BUTTON
{"name":"앱링크버튼","type":"AL","scheme_android":"https://kakao.com", "scheme_ios":"https://kakao.com","url_mobile":"https://kakao.com"},
{"name":"웹링크버튼","type":"WL","scheme_android":"https://google.com", "scheme_ios":"https://google.com","url_mobile":"https://google.com"}
]'
  ,  false ##FALL_BACK_YN
  ,  '{"img_url":"https://mud-kage.kakao.com/dn/c0In8v/btsHt1XNqdN/H7Ee9ajYyFN2oRnEYKLXnk/img_l.jpg", "img_link":"https://google.com"}' ##IMAGE
  ,  '브랜드 메시지 부가정보 '
  ,  '{"title":"커머스 전문형", "REGULAR_price":"30000", "discount_price":"28000", "discount_rate":"10"}'           ##COMMERCE
);

코드예제BM(브랜드메시지) 자유형 캐러셀 커머스 타입 발송 

INSERT INTO BM_MESSAGE (
    UPGRADE_TP
  , MSG_TYPE
  , MOBILE_NO
  , SENDER_NO
  , FALL_BACK_YN
  , CAROUSEL
)
VALUES(
    'FY'          ##UPGRADE_TP
  , 'U_FA'       ##MSG_TYPE
  , '[수신번호]'  ##MOBILE_NO
  , '[발번호]'    ##SENDER_NO
  , false        ##FALL_BACK_YN
  , ' {
"head": {
"header": "인트로 피드 헤더",
"content": "인트로 피드 컨텐츠",
"image_url": "https://mud-kage.kakao.com/dn/gjrnu/btsK41ZYp5e/QoSXrY1fGnYnll4dWdQp10/img_l.jpg"
},
"list": [
{
"attachment": {
"image": {
"img_url": "https://mud-kage.kakao.com/dn/gjrnu/btsK41ZYp5e/QoSXrY1fGnYnll4dWdQp10/img_l.jpg"
},
"button": [
{
"name": "버튼1",
"type": "WL",
"url_mobile": "https://daum.net"
},
{
"name": "버튼2",
"type": "AL",
"url_mobile": "https://daum.net",
"scheme_android": "https://daum.net"
}
],
"coupon": {
"title": "99999원 할인 쿠폰",
"description": "쿠폰 설명",
"url_mobile": "https://daum.net"
},
"commerce": {
"title": "1번 캐러셀 커머스 피드 타이틀",
"regular_price": 10000,
"discount_price": 9000,
"discount_rate": 10
}
},
"additional_content": "1번 캐러셀 커머스 피드 부가정보"
},
{
"attachment": {
"image": {
"img_url": "https://mud-kage.kakao.com/dn/gjrnu/btsK41ZYp5e/QoSXrY1fGnYnll4dWdQp10/img_l.jpg"
},
"button": [
{
"name": "버튼1",
"type": "WL",
"url_mobile": "https://daum.net"
},
{
"name": "버튼2",
"type": "AL",
"url_mobile": "https://daum.net",
"scheme_android": "https://daum.net"
}
],
"coupon": {
"title": "99999원 할인 쿠폰",
"description": "쿠폰 설명",
"url_mobile": "https://daum.net"
},
"commerce": {
"title": "2번 캐러셀 커머스 피드 타이틀",
"regular_price": 20000000
}
},
"additional_content": "2번 캐러셀 커머스 피드 부가정보"
}
],
  "tail": {
    "url_pc": "https://daum.net",
    "url_mobile": "https://daum.net"
  }
}'
);

코드예제BM(브랜드메시지) 기본형 - 텍스트, 이미지, 와이드 이미지 템플릿 변수 미사용 발송 

INSERT INTO BM_MESSAGE(
    UPGRADE_TP
  , MSG_TYPE
  , TARGET
  , TEMPLATE_CODE
  , MOBILE_NO
  , SENDER_NO
  , FALL_BACK_YN
)
VALUES (
    'BN'           ##UPGRADE_TP
  , 'U_FT'        ##MSG_TYPE
  , 'I'           ##TARGET
  , '04cabba33f59dced360634edec53b95c183c9ca3' ##TEMPLATE_CODE
  , '[수신번호]' ##MOBILE_NO
  , '[발신번호]' ##SENDER_NO
  ,  false ##FALL_BACK_YN
);

코드예제BM(브랜드메시지) 기본형 - 텍스트, 이미지, 와이드 이미지 템플릿 변수 분리형 발송 

INSERT INTO BM_MESSAGE(
    UPGRADE_TP
  , MSG_TYPE
  , TARGET
  , TEMPLATE_CODE
  , MOBILE_NO
  , SENDER_NO
  , MESSAGE
  , BUTTON
  , FALL_BACK_YN
)
VALUES(
    'BV' ##UPGRADE_TP
  , 'U_FT' ##MSG_TYPE
  , 'I' ##TARGET
  , '04cabba33f59dced360634edec53b95c183c9ca3' ##TEMPLATE_CODE
  , '[수신번호]' ##MOBILE_NO
  , '[발신번호]' ##SENDER_NO
  ,  '{"변수":"message 본문,\\nbrandMessage\\n전문"}'	##MESSAGE(KEY:VALUE사용)
  , '{"URL변수":"kakao.com"}'							##BUTTON
  ,  0 ##FALL_BACK_YN
);

코드예제BM(브랜드메시지) 기본형 - 텍스트, 이미지, 와이드 이미지 템플릿 전문형 발송 

INSERT INTO BM_MESSAGE (
    UPGRADE_TP
  , MSG_TYPE
  , TARGET
  , TEMPLATE_CODE
  , MOBILE_NO
  , SENDER_NO
  , MESSAGE
  , BUTTON
  , FALL_BACK_YN
)
VALUES(
    'BM' ##UPGRADE_TP
  , 'U_FT' ##MSG_TYPE
  , 'I' ##TARGET
  , '04cabba33f59dced360634edec53b95c183c9ca3' ##TEMPLATE_CODE
  , '[수신번호]' ##MOBILE_NO
  , '[발신번호]' ##SENDER_NO
  , 'message 본문,\nbrandMessage\n전문'	         ##MESSAGE
  , '[{ "type":"WL","url_mobile":"https://kakao.com"}]'	##BUTTON
  , 0 ##FALL_BACK_YN
);

코드예제BM(브랜드메시지) 기본형 - 텍스트, 이미지, 와이드 이미지 템플릿 변수분리형 발송 

INSERT INTO BM_MESSAGE (
    UPGRADE_TP
  , MSG_TYPE
  , TARGET
  , MOBILE_NO
  , SENDER_NO
  , FALL_BACK_YN
  , TEMPLATE_CODE
  , MESSAGE
  , BUTTON
  , COUPON
)
VALUES(
    'BV' ##UPGRADE_TP
  , 'U_FT' ##MSG_TYPE
  , 'I' ##TARGET
  , '[수신번호]' ##MOBILE_NO
  , '[발신번호]' ##SENDER_NO
  , 0 ##FALL_BACK_YN
  , '1ef59be8af923c1f98b7d6517d2d8be3153d224a'
  , '{"본문":"변수분리형\n본문\n입니다."}'         ##MESSAGE KEY:VALUE
  , '{"type": "WL", "링크": "buttonLink"}'        ##BUTTON KEY:VALUE 사용
  , '{"할인금액":"10", "mobile변수":"mobile", "pc변수":"pc" }'
);

코드예제BM(브랜드메시지) 기본형 – 텍스트 쿠폰 전문형 발송 

INSERT INTO BM_MESSAGE
(
    UPGRADE_TP
  , MSG_TYPE
  , TARGET
  , MOBILE_NO
  , SENDER_NO
  , FALL_BACK_YN
  , TEMPLATE_CODE
  , MESSAGE
  , BUTTON
  , COUPON
)
VALUES (
    'BM' ##UPGRADE_TP
  , 'U_FT' ##MSG_TYPE
  , 'I' ##TARGET
  , '[수신번호]' ##MOBILE_NO
  , '[발신번호]' ##SENDER_NO
  ,  0 ##FALL_BACK_YN
  ,  '1ef59be8af923c1f98b7d6517d2d8be3153d224a'
  ,  '{친구톡 업그레이드 발송 테스트\n메시지타입: BM\n고객사명 U_FT\n2025-06-10 14:17:00}'
  ,  '[{"type": "WL", "url_mobile": "https://daum.net/test1"}]'
  , '{
"title": "10원 할인 쿠폰",
"url_mobile": "https://daum.net/#{mobile변수}",
"url_pc": "https://daum.net/test1"
}'
);

코드예제BM(브랜드메시지) 기본형 – 와이드 리스트 전문형 발송 

INSERT INTO BM_MESSAGE (
    UPGRADE_TP
  , MSG_TYPE
  , TARGET
  , TEMPLATE_CODE
  , MOBILE_NO
  , SENDER_NO
  , ITEM
  , HEADER
  , FALL_BACK_YN
)
VALUES(
    'BM' ##UPGRADE_TP
  , 'U_FL' ##MSG_TYPE
  , 'I' ##TARGET
  , '650a88696e322cf81fd8dd79d7a252fbf940e24c' ##TEMPLATE_CODE
  , '[수신번호]' ##MOBILE_NO
  , '[발신번호]' ##SENDER_NO
  ,  '[{"title":"타이틀1"}, {}, {"title":"타이틀3", "url_mobile": "https://daum.net"}]'
  ,  '와이드 리스트 전문형'
  ,  0 ##FALL_BACK_YN
);

코드예제MySQLBM(브랜드메시지) 기본형 – 와이드 리스트 변수분리형 발송 

INSERT INTO BM_MESSAGE (
    UPGRADE_TP
  , MSG_TYPE
  , TARGET
  , TEMPLATE_CODE
  , MOBILE_NO
  , SENDER_NO
  , MESSAGE
  , FALL_BACK_YN
)
VALUES(
    'BV' ##UPGRADE_TP
  , 'U_FL' ##MSG_TYPE
  , 'I' ##TARGET
  , '650a88696e322cf81fd8dd79d7a252fbf940e24c' ##TEMPLATE_CODE
  , '[수신번호]' ##MOBILE_NO
  , '[발신번호]' ##SENDER_NO
  , '{"LDAPID":"collin", "타이틀1":"타이틀1", "타이틀3":"타이틀3", "mobile_link":"daum.net/test1"}'
  , 0 ##FALL_BACK_YN
);

코드예제BM(브랜드메시지) 기본형 – 캐러셀피드 전문형 발송 

INSERT INTO BM_MESSAGE (
    UPGRADE_TP
  , MSG_TYPE
  , TARGET
  , TEMPLATE_CODE
  , MOBILE_NO
  , SENDER_NO
  , ITEM
  , HEADER
  , FALL_BACK_YN
)
VALUES (
    'BM' ##UPGRADE_TP
  , 'U_FL' ##MSG_TYPE
  , 'I' ##TARGET
  , '650a88696e322cf81fd8dd79d7a252fbf940e24c' ##TEMPLATE_CODE
  , '[수신번호]' ##MOBILE_NO
  , '[발신번호]' ##SENDER_NO
  , '[{"title":"타이틀1"}, {}, {"title":"타이틀3", "url_mobile": "https://daum.net"}]'
  , '와이드 리스트 collin'
  , 0 ##FALL_BACK_YN
);

코드예제BM(브랜드메시지) 기본형 – 캐러셀피드 변수 분리형 발송 

INSERT INTO BM_MESSAGE (
    UPGRADE_TP
  , MSG_TYPE
  , TARGET
  , TEMPLATE_CODE
  , MOBILE_NO
  , SENDER_NO
  , FALL_BACK_YN
  , CAROUSEL
)
VALUES(
    'BV' ##UPGRADE_TP
  , 'U_FC' ##MSG_TYPE
  , 'I' ##TARGET
  , 'b7a5cb5a9b4fc0656f61e9dd7512965c27657c51' ##TEMPLATE_CODE
  , '[수신번호]' ##MOBILE_NO
  , '[발신번호]' ##SENDER_NO
  , 0 ##FALL_BACK_YN
  , '[{},{"message_variable":{"헤더2":"케러셀 헤더2", "변수":"캐러셀 변수2"}, "button_variable":{"linkIos":"test1", "linkMo":"test2"}}]'
);

코드예제BM(브랜드메시지) 기본형 –프리미엄 동영상 전문형 발송 

INSERT INTO BM_MESSAGE (
    UPGRADE_TP
  , MSG_TYPE
  , TARGET
  , TEMPLATE_CODE
  , MOBILE_NO
  , SENDER_NO
  , MESSAGE
  , FALL_BACK_YN
)
VALUES (
    'BM' ##UPGRADE_TP
  , 'U_FP' ##MSG_TYPE
  , 'I' ##TARGET
  , 'fc9d96887cb5a9b2e7f9dab08e5128c757e18cb4' ##TEMPLATE_CODE
  , '[수신번호]' ##MOBILE_NO
  , '[발신번호]' ##SENDER_NO
  , '친구톡 업그레이드 발송 테스트 메시지타입: 프리미엄동영상(BM) 고객사명 DKT 2025-06-09 15:31'
  , 0 ##FALL_BACK_YN
);

코드예제BM(브랜드메시지) 기본형 –프리미엄 동영상 변수 분리형 발송 

INSERT INTO BM_MESSAGE (
    UPGRADE_TP
  , MSG_TYPE
  , TARGET
  , TEMPLATE_CODE
  , MOBILE_NO
  , SENDER_NO
  , MESSAGE
  , FALL_BACK_YN
)
VALUES(
    'BV' ##UPGRADE_TP
  , 'U_FP' ##MSG_TYPE
  , 'I' ##TARGET
  , 'fc9d96887cb5a9b2e7f9dab08e5128c757e18cb4' ##TEMPLATE_CODE
  , '[수신번]' ##MOBILE_NO
  , '[발신번호]' ##SENDER_NO
  , '{"타입":"프리미엄동영상(U_FP)", "상품명":"변수분리형", "테스트데이트":"2025-06-09 15:29"}'
  , 0 ##FALL_BACK_YN
);

코드예제BM(브랜드메시지) 기본형 –커머스 전문형 발송 

INSERT INTO BM_MESSAGE (
    UPGRADE_TP
  , MSG_TYPE
  , TARGET
  , TEMPLATE_CODE
  , MOBILE_NO
  , SENDER_NO
  , COMMERCE
  , BUTTON
  , FALL_BACK_YN
)
VALUES(
    'BM' ##UPGRADE_TP
  , 'U_FM' ##MSG_TYPE
  , 'I' ##TARGET
  , '6183a500d2f02bda9d9aa3083ee0ea26fbdcba93' ##TEMPLATE_CODE
  , '[수신번호]' ##MOBILE_NO
  , '[발신번호]' ##SENDER_NO
  , '{"title":"커머스 전문형", "REGULAR_price":"30000", "discount_price":"28000", "discount_rate":"10"}'
  , '[{"TYPE":"WL", "URL_MOBILE":"https://daum.net/test1"}]'
  , 0 ##FALL_BACK_YN
);

코드예제BM(브랜드메시지) 기본형 –커머스 변수 분리형 발송 

INSERT INTO BM_MESSAGE (
    UPGRADE_TP
  , MSG_TYPE
  , TARGET
  , TEMPLATE_CODE
  , MOBILE_NO
  , SENDER_NO
  , COMMERCE
  , BUTTON
  , FALL_BACK_YN
)
VALUES(
    'BV' ##UPGRADE_TP
  , 'U_FM' ##MSG_TYPE
  , 'I' ##TARGET
  , '6183a500d2f02bda9d9aa3083ee0ea26fbdcba93' ##TEMPLATE_CODE
  , '[수신번호]' ##MOBILE_NO
  , '[발신번호]' ##SENDER_NO
  , '{"상품명": "커머스", "정상가격": "30000", "할인가격":"28000", "정액할인가격":"2000"}'
  , '{"모바일변수": "test1"}'
  , 0 ##FALL_BACK_YN
);

코드예제BM(브랜드메시지) 기본형 –캐러셀커머스 전문형 발송 

INSERT INTO BM_MESSAGE (
    UPGRADE_TP
  , MSG_TYPE
  , TARGET
  , TEMPLATE_CODE
  , MOBILE_NO
  , SENDER_NO
  , FALL_BACK_YN
  , CAROUSEL
)
VALUES(
    'BM' ##UPGRADE_TP
  , 'U_FA' ##MSG_TYPE
  , 'I' ##TARGET
  , '26cb848e719b3fd91576d12b43002135c2ee0340' ##TEMPLATE_CODE
  , '[수신번호]' ##MOBILE_NO
  , '[발신번호]' ##SENDER_NO
  , 0 ##FALL_BACK_YN
  , '{"list":[
{
"additional_content": "1번의 부가정보 (부가변수)",
"attachment":{
"commerce": {
"title": "상품명1",
"regular_price": "5500",
"discount_price": "500",
"discount_rate": "10",
"discount_fixed": "5000"
}
}
},
{
"attachment":{
"commerce": {
"title": "상품명",
"regular_price": "6000",
"discount_price": "600",
"discount_rate": "100",
"discount_fixed": "5400"
}
,"button": [
{
"type": "WL",
"url_mobile": "https://daum.net"
}
]
}
}
]}'
);

코드예제BM(브랜드메시지) 기본형 –캐러셀커머스 변수 분리형 발송 

INSERT INTO BM_MESSAGE (
    UPGRADE_TP
  , MSG_TYPE
  , TARGET
  , TEMPLATE_CODE
  , MOBILE_NO
  , SENDER_NO
  , FALL_BACK_YN
  , CAROUSEL
)
VALUES (
    'BV' ##UPGRADE_TP
  , 'U_FC' ##MSG_TYPE
  , 'I' ##TARGET
  , 'b7a5cb5a9b4fc0656f61e9dd7512965c27657c51' ##TEMPLATE_CODE
  , '[수신번호]' ##MOBILE_NO
  , '[발신번호]' ##SENDER_NO
  ,  0 ##FALL_BACK_YN
  ,  '[{}
,{"message_variable":{"헤더2":"케러셀 헤더2", "변수":"캐러셀 변수2"}, "button_variable":{"linkIos":"test1", "linkMo":"test2"}
,"coupon_variable": {"상품명":"변수분리", "mobile": "mobile", "pc": "pc"}}]'
);

[참고] 브랜드메시지 객체 설명

자유형, 기본형 발송 SQL 작성시 참고합니다.

  • 기본형 발송시 변수부가 사용된 부분만 작성합니다.
  • 전문형 LIST TYPE의 경우 변수부가 없을때에는 {} 형태 입력
표Button 데이터 구조(리스트)
프로퍼티 타입 필수여부 설명
name String O 버튼 제목
ㄴ 자유형만 사용
ㄴ 기본형 사용 시 발송 실패
type String O 버튼 타입
scheme_android String 안드로이드 환경에서 클릭 시 실행할
application custom scheme
scheme_ios String iOS 환경에서 클릭 시 실행할
application custom scheme
url_mobile String MOBILE 환경에서 클릭 시 이동할 URL
url_pc String PC 환경에서 클릭 시 이동할 URL
chat_extra String 상담톡<->카카오톡 챗봇 전환 시 전달할 메타정보
chat_event String 카카오톡 챗봇 전환 시 연결할 카카오톡 챗봇 이벤트명
biz_form_key text 비즈니스폼키
표Commerce 데이터 구조
프로퍼티 타입 필수여부 설명
title String O 상품 제목
최대 30자 (줄바꿈: 불가)
regular_price int O 정상 가격 (0 ~ 99,999,999)
discount_price int 할인 후 가격 (0 ~ 99,999,999)
discount_rate int 할인율 (0 ~ 100)
할인 가격 존재시 할인율, 정액 할인 가격 중 하나는 필수
discount_fixed int 정액 할인 가격 (0 ~ 999,999)
할인 가격 존재시 할인율, 정액 할인 가격 중 하나는 필수
표Image 데이터 구조
프로퍼티 타입 필수여부 설명
img_url text O 이미지 업로드 API로 등록한 이미지 URL
img_link text(1000) 이미지 클릭시 이동할 URL
미설정시 카카오톡 내 이미지 뷰어 사용
표Video 데이터 구조
프로퍼티 타입 필수여부 설명
video_url text(500) O 카카오TV 동영상 URL
thumbnail_url text(1000) O 이미지 업로드 API로 등록한 동영상 썸네일용 이미지 URL (기본값: 동영상 기본 썸네일 이미지)
thumbnail_url 필드 필수
video_url이 비공개 동영상
표Item 데이터 구조( 리스트 )
프로퍼티 타입 필수여부 설명
title text(30) O 아이템 제목
1번째 아이템 - 최대 25자 (줄바꿈: 최대 1개)
2~4번째 아이템 - 최대 30자 (줄바꿈: 최대 1개)
img_url text O 아이템 이미지 URL
scheme_android text(1000) MOBILE Android 환경에서 클릭 시 실행할
application custom scheme
scheme_ios text(1000) MOBILE iOS 환경에서 클릭 시 실행할
application custom scheme
url_mobile text(1000) O MOBILE 환경에서 클릭 시 이동할 URL
url_pc text(1000) PC 환경에서 클릭 시 이동할 URL
표Coupon 데이터 구조
프로퍼티 타입 필수여부 설명
title text O 쿠폰 제목
사용 가능한 쿠폰 제목
- ${숫자}원 할인 쿠폰 (숫자: 1 ~ 99,999,999)
- ${숫자}% 할인 쿠폰 (숫자: 1 ~ 100)
- 배송비 할인 쿠폰
- ${7자 이내} 무료 쿠폰
- ${7자 이내} UP 쿠폰
description text O 쿠폰 설명
U_FW, U_FL, U_FP - 최대 18자 (줄바꿈: 불가)
그 외 - 최대 12자 (줄바꿈: 불가)
url_pc text(1000) PC 환경에서 클릭 시 이동할 URL
url_mobile text(1000) MOBILE 환경에서 클릭 시 이동할 URL
scheme_android text(1000) MOBILE Android 환경에서 클릭 시 실행할
application custom scheme
scheme_ios text(1000) MOBILE IOS 환경에서 클릭 시 실행할
application custom scheme
표Carousel 데이터 구조
프로퍼티 타입 필수여부 설명
head Head 캐러셀 인트로
tail Tail 캐러셀 더보기
ㄴ 기본형(변수분리형/전문형) 미사용
list List<FtCarousel> 캐러셀 목록
ㄴ 인트로 사용시 최대 5개
ㄴ 인트로 미사용시 최대 6개
표Head 데이터 구조
프로퍼티 타입 필수여부 설명
header text(20) O 캐러셀 인트로 헤더
최대 20자 (줄바꿈: 불가)
content text(50) O 캐러셀 인트로 내용
최대 50자 (줄바꿈: 최대 2개)
image_url text O 이미지 업로드 API로 등록한 캐러셀 인트로 이미지 URL
url_mobile text(1000) MOBILE 환경에서 클릭 시 이동할 URL
url_pc text(1000) PC 환경에서 클릭 시 이동할 URL
scheme_android text(1000) MOBILE Android 환경에서 클릭 시 실행할
application custom scheme
scheme_ios text(1000) MOBILE iOS 환경에서 클릭 시 실행할
application custom scheme
표Tail 데이터 구조
프로퍼티 타입 필수여부 설명
url_pc text(1000) PC 환경에서 클릭 시 이동할 URL
url_mobile text(1000) O MOBILE 환경에서 클릭 시 이동할 URL
scheme_ios text(1000) MOBILE iOS 환경에서 클릭 시 실행할
application custom scheme
scheme_android text(1000) MOBILE Android 환경에서 클릭 시 실행할
application custom scheme
표FtCarousel 데이터 구조
프로퍼티 타입 필수여부 설명
header text(20) 캐러셀 리스트 헤더
최대 20자 (줄바꿈: 불가)

header 필드 필수
- message_type : U_FC

header 필드 사용불가
- message_type : U_FA
message text(180) 캐러셀 리스트 메시지
최대 180자 (줄바꿈: 최대 2개)

- message_type이 U_FC인 경우 필수
- message_type이 U_FA인 경우 사용불가
additional_content text(34) 캐러셀 리스트 부가 정보
최대 34자 (줄바꿈: 최대 1개)

- message_type이 U_FC인 경우 사용 불가
attachment CarouselAttachment O 캐러셀 아이템 이미지, 버튼 정보
표CarouselAttachment 데이터 구조
프로퍼티 타입 필수여부 설명
button List<Button> 최소 1개, 최대 2개
- button
- 상위 button 객체 동일
image Image O - 상위 image 객체 동일
coupon Coupon - 상위 Coupon 객체 동일
commerce Commerce - 상위 Commerce 객체 동일
기본형 변수 분리형 발송시 객체 설명을 참고하여 작성합니다. 표( 공통 ) MESSAGE, BUTTON, COMMERCE, COUPON, VIDEO, IMAGE
프로퍼티 타입 필수여부 설명
[TYPE_NAME] Map<String, String> - 변수분리형 변수(KEY:VALUE)
ㄴ 변수부가 있는 부분만 작성
표Carousel 데이터 구조( 리스트 )
프로퍼티 타입 필수여부 설명
message_variable Map<String, String> - 캐러셀 커머스 메시지 변수
button_variable Map<String, String> - 캐러셀 커머스 버튼 변수
image_variable Map<String, String> - 캐러셀 커머스 이미지 변수
commerce_variable Map<String, String> - 캐러셀 커머스 변수
coupon_variable Map<String, String> - 캐러셀 쿠폰 변수
이 문서가 만족스러운 이유를 알려주세요.
이 문서에 아쉬운 점을 알려주세요.
평가해주셔서 감사합니다.

더 자세한 의견은 contact.dkt@kakaocorp.com 으로 제보해주세요.