2.4 카카오톡 메시지

1. 알림톡 발송 V1.2

카카오 알림톡을 발송합니다. 알림톡은 기업이 카카오톡을 통해 고객에게 중요한 정보를 전달할 수 있는 비대면 알림 서비스입니다.

📌 주의사항

한 번에 최대 10명의 수신자에게 발송할 수 있습니다.
발신번호는 사전에 등록된 번호만 사용 가능합니다.
예약발송은 현재 시점으로부터 최대 30일까지 가능합니다.
템플릿 코드는 사전에 승인된 것만 사용 가능합니다.
버튼은 최대 5개까지 추가 가능합니다.
단축URL 사용 시 메시지 길이가 제한될 수 있습니다.

📌 버튼 타입 설명

타입	설명	필수 입력
WL	웹링크	url_mobile 필수, url_pc 선택
AL	앱링크	linkIos, linkAnd, linkMo 중 2개 이상 필수
BK	봇 키워드	해당 버튼 텍스트 전송
MD	메시지 전달	해당 버튼 텍스트 + 메시지 본문 전송
BC	상담톡 전환	상담톡 서비스를 이용하고 있을 경우 상담톡으로 전환
BT	봇 전환	채널 봇으로 전환
DS	배송조회	메시지 내 송장번호로 배송조회 페이지 연결 (quickReplies 사용 불가)
AC	채널추가	광고추가형/복합형 템플릿에서만 사용 가능, 버튼단톡 또는 첫번째 버튼에만 추가 가능 (quickReplies 사용 불가)

1) 요청 (Request)

URL

POST /msg/v1.2/alimtalk HTTP/1.1

Headers

Name	Type	필수	설명
Authorization	String	●	사용자 인증 토큰
Content-Type	String	●	`application/json`

Request Body

Name	Type	필수	설명	크기
clickUrlYn	String	-	단축URL 사용여부 (Y/N)	1자
resvYn	String	-	예약발송 여부 (Y/N)	1자
resvReqDt	String	-	예약발송 시간 (ex. 2025-07-13 13:15)	-
agency	Object	-	대행사 정보	-
callback	String	●	발신번호	20자
campaignId	String	-	캠페인 ID	20자
deptCode	String	-	부서 코드	20자
title	String	-	타이틀	-
itemHeader	String	-	헤더	-
itemHighlightTitle	String	-	요약정보	-
itemHighlightDescription	String	-	요약내용	-
msg	String	●	메시지 내용	1,000자
item	Object	-	아이템리스트 정보	-
kkoChId	String	●	카카오채널 ID	61자
tmpltCode	String	●	템플릿 코드	-
service	Integer	-	서비스 번호	-
recvInfoLst	Array	●	수신자 정보 목록	10개
fbInfoLst	Array	-	대체 발송 정보	-
buttons	Array	●	버튼 리스트	-
groupKey	String	-	알림톡 그룹키	200자

item 객체

Name	Type	필수	설명	크기
list	Array	●	아이템리스트, 최소 2개, 최대 10개까지 가능	-
list[].title	String	●	아이템리스트 타이틀	6자
list[].description	String	●	아이템리스트 설명	23자
summary	Object	-	아이템리스트 설명	-
summary.title	String	●	타이틀	6자
summary.description	String	-	설명 (변수 및 화폐 단위, 숫자, 쉼표, 마침표만 사용 가능)	14자

buttons 객체

Name	Type	필수	설명	크기
name	String	●	버튼이름	14자
type	String	●	버튼타입	2자
linkMo	String	-	mobile 환경에서 버튼 클릭 시 이동할 url	-
linkPc	String	-	pc 환경에서 버튼 클릭 시 이동할 url	-
linkAnd	String	-	mobile android 환경에서 버튼 클릭 시 실행할 application custom scheme	-
linkIos	String	-	mobile ios 환경에서 버튼 클릭 시 실행할 application custom scheme	-
ordering	Integer	-	버튼 노출 순서	-
varUrlYn	String	-	URL 가변 값 포함 여부	-
kkoBtnOutbrowserYn	String	-	버튼 클릭시 url 이 열리는 브라우저 설정	-
chat_extra	String	-	봇관련 정보(type:BC,BT)	64자
chat_event	String	-	봇관련 이벤트정보(type:BT)	64자

2) 응답 (Response)

Response Body

Name	Type	설명
code	String	결과 코드
message	String	결과 메시지
data	Array	결과 데이터 목록
data[].cliKey	String	클라이언트 키
data[].msgKey	String	메시지 키
data[].phone	String	수신번호
data[].code	String	결과 코드
data[].message	String	결과 메시지

3) 요청 예시 (Sample)

Curl

아이템리스트형 이외의 템플릿

curl -X POST "https://api.msghub.uplus.co.kr/msg/v1.2/alimtalk" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
        "clickUrlYn": "N",
        "resvYn": "N",
        "resvReqDt": "2025-07-13 13:15",
        "agency": {
          "kisaOrigCode": "123456789"
        },
        "callback": "0212341234",
        "title": "U+ Cloud 서비스 알림",
        "msg": "안녕하세요. #{name} 고객님.\n\nU+ Cloud서비스에서 설정하신 일일 사용량(1,000건) 초과 사용을 알려드립니다.\n\n※ 사용량 제한 및 기타 자세한 사항은 홈페이지 참조",
        "kkoChId": "@myservice",
        "tmpltCode": "TPnJhpG82k",
        "recvInfoLst": [
          {
            "cliKey": "test001",
            "phone": "01012341234",
             "mergeData": {
                "name": "홍길동"
             }
          },
          {
            "cliKey": "test002",
            "phone": "01056785678",
             "mergeData": {
                "name": "김철수"
             }
          }
        ],
        "buttons": [
          {
            "name": "사용량 제한 이용안내",
            "type": "WL",
            "url_mobile": "https://m.uplus.co.kr/cloud/usage",
            "url_pc": "https://www.uplus.co.kr/cloud/usage"
          },
          {
            "name": "포인트 전환하기",
            "type": "AL",
            "linkMo": "https://m.uplus.co.kr/point",
            "linkAnd": "upluscloud://point/convert",
            "linkIos": "upluscloud://point/convert"
          }
        ]
  }'

아이템리스트형 템플릿

curl -X POST "https://api.msghub.uplus.co.kr/msg/v1.2/alimtalk" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
        "clickUrlYn": "N",
        "resvYn": "N",
        "resvReqDt": "2025-07-13 13:15",
        "agency": {
          "kisaOrigCode": "123456789"
        },
        "callback": "0212341234",
        "title": "U+ Cloud 서비스 알림",
        "msg": "안녕하세요. #{name} 고객님.\n\nU+ Cloud서비스에서 설정하신 일일 사용량(1,000건) 초과 사용을 알려드립니다.\n\n※ 사용량 제한 및 기타 자세한 사항은 홈페이지 참조",
        "kkoChId": "@myservice",
        "tmpltCode": "TPnJhpG82k",
        "recvInfoLst": [
          {
            "cliKey": "test001",
            "phone": "01012341234",
             "mergeData": {
                "name": "홍길동"
             }
          },
          {
            "cliKey": "test002",
            "phone": "01056785678",
             "mergeData": {
                "name": "김철수"
             }
          }
        ],
        "item": {
            "list": [
              {
                "title": "test01",
                "description": "test01"
              },
              {
                "title": "test02",
                "description": "test02"
              }
            ],
            "summary": {
              "title": "테스트",
              "description": "1,000,000원"
            }
         },
        "itemHeader":"헤더",
        "itemHighlightTitle": "타이틀",
        "itemHighlightDescription": "설명",
        "buttons": [
          {
            "name": "사용량 제한 이용안내",
            "type": "WL",
            "url_mobile": "https://m.uplus.co.kr/cloud/usage",
            "url_pc": "https://www.uplus.co.kr/cloud/usage"
          },
          {
            "name": "포인트 전환하기",
            "type": "AL",
            "linkMo": "https://m.uplus.co.kr/point",
            "linkAnd": "upluscloud://point/convert",
            "linkIos": "upluscloud://point/convert"
          }
        ]
  }'

Response

{
  "code": "10000",
  "message": "성공",
  "data": [
    {
      "cliKey": "test001",
      "msgKey": "3jVnyk0m8U.6fKG1w",
      "phone": "01012341234",
      "code": "10000",
      "message": "성공"
    },
    ...
  ]
}

2. 친구톡 발송 V1.2

카카오 친구톡을 발송합니다. 친구톡은 카카오톡 채널을 구독한 친구들에게 마케팅 메시지를 전송할 수 있는 서비스입니다.

📌 주의사항

한 번에 최대 10명의 수신자에게 발송할 수 있습니다.
발신번호는 사전에 등록된 번호만 사용 가능합니다.
예약발송은 현재 시점으로부터 최대 30일까지 가능합니다.
광고성 메시지(adFlag=Y)의 경우 무료수신거부 문구가 자동으로 추가됩니다.
버튼은 최대 5개까지 추가 가능합니다.
단축URL 사용 시 메시지 길이가 제한될 수 있습니다.

📌 버튼 타입 설명

타입	설명	필수 입력
WL	웹링크	url_mobile 필수, url_pc 선택
AL	앱링크	linkIos, linkAnd, linkMo 중 2개 이상 필수
BK	봇 키워드	해당 버튼 텍스트 전송
MD	메시지 전달	해당 버튼 텍스트 + 메시지 본문 전송
BC	상담톡 전환	상담톡 서비스를 이용하고 있을 경우 상담톡으로 전환
BT	봇 전환	채널 봇으로 전환
DS	배송조회	메시지 내 송장번호로 배송조회 페이지 연결 (quickReplies 사용 불가)
AC	채널추가	광고추가형/복합형 템플릿에서만 사용 가능, 버튼단톡 또는 첫번째 버튼에만 추가 가능 (quickReplies 사용 불가)

1) 요청 (Request)

URL

POST /msg/v1.2/friendtalk HTTP/1.1

Headers

Name	Type	필수	설명
Authorization	String	●	사용자 인증 토큰
Content-Type	String	●	`application/json`

Request Body

Name	Type	필수	설명	크기
clickUrlYn	String	-	단축URL 사용여부 (Y/N)	1자
resvYn	String	-	예약발송 여부 (Y/N)	1자
resvReqDt	String	-	예약발송 시간 (ex. 2025-07-13 13:15)	-
agency	Object	-	대행사 정보	-
callback	String	●	발신번호	20자
campaignId	String	-	캠페인 ID	20자
deptCode	String	-	부서 코드	20자
wideImageYn	String	-	와이드 이미지 여부 (Y/N)	1자
fileId	String	-	파일 아이디	-
adFlag	String	●	광고 표기 여부 (Y/N)	1자
msg	String	●	메시지 내용	1,000자
image	Object	-	이미지 정보	-
kkoChId	String	●	카카오채널 ID	61자
recvInfoLst	Array	●	수신자 정보 목록	10개
fbInfoLst	Array	-	Fallback 정보 목록	-
header	String	-	와이드 아이템리스트 상단 헤더	-
item	Array	-	와이드아이템리스트형 정보	-
carousel	Object	-	캐러셀 정보	-
coupon	Object	-	쿠폰 정보	-
buttons	Array	-	버튼 정보	-
video	Object	-	동영상 정보	-

image 객체

Name	Type	필수	설명	크기
imgUrl	String	●	이미지 URL	300자
imgLink	String	-	이미지 클릭 시 이동 URL	300자

item 객체

Name	Type	필수	설명	크기
list	Array	●	아이템리스트, 최소 2개, 최대 10개까지 가능	-
list[].title	String	●	아이템리스트 타이틀	6자
list[].description	String	●	아이템리스트 설명	23자
summary	Object	-	아이템리스트 설명	-
summary.title	String	●	타이틀	6자
summary.description	String	-	설명 (변수 및 화폐 단위, 숫자, 쉼표, 마침표만 사용 가능)	14자

carousel 객체

Name	Type	필수	설명	크기
list	Array	●	캐러셀 목록	-
list[].header	String	●	캐러셀 리스트 헤더	20자
list[].message	String	●	캐러셀 리스트 내용	180자
list[].attachment	Object	●	캐러셀 이미지 정보	-
list[].attachment.image	Object	●	캐러셀 이미지 정보	-
list[].attachment.image.imgUrl	String	●	이미지 URL	-
list[].attachment.image.imgLink	String	-	이미지 링크	-
list[].attachment.button	Array	-	버튼 정보	-
list[].attachment.button[].name	String	●	버튼이름	14자
list[].attachment.button[].type	String	●	버튼타입	2자
list[].attachment.button[].linkMo	String	-	mobile 환경에서 버튼 클릭 시 이동할 url	-
list[].attachment.button[].linkPc	String	-	pc 환경에서 버튼 클릭 시 이동할 url	-
list[].attachment.button[].linkAnd	String	-	mobile android 환경에서 버튼 클릭 시 실행할 application custom scheme	-
list[].attachment.button[].llinkIos	String	-	mobile ios 환경에서 버튼 클릭 시 실행할 application custom scheme	-
tail	Object	-	더보기 정보	-
tail.linkMo	String	-	mobile 환경에서 버튼 클릭 시 이동할 url	-
tail.linkPc	String	-	pc 환경에서 버튼 클릭 시 이동할 url	-
tail.linkAnd	String	-	mobile android 환경에서 버튼 클릭 시 실행할 application custom scheme	-
tail.linkIos	String	-	mobile ios 환경에서 버튼 클릭 시 실행할 application custom scheme	-

coupon 객체

Name	Type	필수	설명
title	String	●	쿠폰 제목
description	String	●	쿠폰 설명
linkMo	String	-	mobile 환경에서 버튼 클릭 시 이동할 url
linkPc	String	-	pc 환경에서 버튼 클릭 시 이동할 url
linkAnd	String	-	mobile android 환경에서 버튼 클릭 시 실행할 application custom scheme
linkIos	String	-	mobile ios 환경에서 버튼 클릭 시 실행할 application custom scheme

video 객체

Name	Type	필수	설명
videoUrl	String	●	카카오tv 동영상 URL
thumbnailUrl	String	-	썸네일용 이미지 URL

buttons 객체

Name	Type	필수	설명	크기
name	String	●	버튼이름	14자
type	String	●	버튼타입	2자
linkMo	String	-	mobile 환경에서 버튼 클릭 시 이동할 url	-
linkPc	String	-	pc 환경에서 버튼 클릭 시 이동할 url	-
linkAnd	String	-	mobile android 환경에서 버튼 클릭 시 실행할 application custom scheme	-
linkIos	String	-	mobile ios 환경에서 버튼 클릭 시 실행할 application custom scheme	-
ordering	Integer	-	버튼 노출 순서	-
varUrlYn	String	-	URL 가변 값 포함 여부	-
kkoBtnOutbrowserYn	String	-	버튼 클릭시 url 이 열리는 브라우저 설정	-
chat_extra	String	-	봇관련 정보(type:BC,BT)	64자
chat_event	String	-	봇관련 이벤트정보(type:BT)	64자

2) 응답 (Response)

Response Body

Name	Type	설명
code	String	결과 코드
message	String	결과 메시지
data	Array	결과 데이터 목록
data[].cliKey	String	클라이언트 키
data[].msgKey	String	메시지 키
data[].phone	String	수신번호
data[].code	String	결과 코드
data[].message	String	결과 메시지

3) 요청 예시 (Sample)

💡 Json 예시

템플릿 유형별 json 예시입니다.

텍스트형

curl -X POST "https://api.msghub.uplus.co.kr/msg/v1.2/friendtalk" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
        "clickUrlYn": "N",
        "resvYn": "N",
        "callback": "0212345678",
        "resvReqDt": "2025-07-13 13:15",
        "agency": {
          "kisaOrigCode": "123456789"
        },
        "adFlag": "Y",
        "msg": "안녕하세요! #{name}님 봄맞이 특별 프로모션 안내입니다.\n\n신규 가입 시 3개월 무료 이용 혜택을 드립니다.\n자세한 내용은 아래 버튼을 클릭해주세요.",
        "kkoChId": "@myservice",
        "recvInfoLst": [
          {
            "cliKey": "test001",
            "phone": "01012341234",
            "mergeData": {
              "name": "홍길동"
            }
          },
          {
            "cliKey": "test002",
            "phone": "01056785678",
            "mergeData": {
              "name": "김철수"
            }
          }
        ],
        "buttons": [
          {
            "name": "프로모션 자세히 보기",
            "type": "WL",
            "url_mobile": "https://m.example.com/promo/spring",
            "url_pc": "https://www.example.com/promo/spring"
          },
          {
            "name": "앱에서 보기",
            "type": "AL",
            "linkMo": "https://m.example.com/app",
            "linkAnd": "example://promo/spring",
            "linkIos": "example://promo/spring"
          }
        ],
      "fbInfoLst": [
        {
          "ch": "SMS",
          "title": "제목",
          "msg": "SMS 메시지 내용"
        }
      ]
  }'

텍스트+이미지형

curl -X POST "https://api.msghub.uplus.co.kr/msg/v1.2/friendtalk" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
        "clickUrlYn": "N",
        "resvYn": "N",
        "callback": "0212345678",
        "resvReqDt": "2025-07-13 13:15",
        "agency": {
          "kisaOrigCode": "123456789"
        },
        "adFlag": "Y",
        "msg": "안녕하세요! #{name}님 봄맞이 특별 프로모션 안내입니다.\n\n신규 가입 시 3개월 무료 이용 혜택을 드립니다.\n자세한 내용은 아래 버튼을 클릭해주세요.",
        "kkoChId": "@myservice",
        "recvInfoLst": [
          {
            "cliKey": "test001",
            "phone": "01012341234",
            "mergeData": {
              "name": "김철수"
            }
          },
          {
            "cliKey": "test002",
            "phone": "01056785678",
            "mergeData": {
              "name": "홍길동"
            }
          }
        ],
       "wideImageYn": "Y",
       "image": {
          "img_url": "https://example.com/images/promo_spring.jpg",
          "img_link": "https://example.com/promo/spring"
        },
        "buttons": [
          {
            "name": "프로모션 자세히 보기",
            "type": "WL",
            "url_mobile": "https://m.example.com/promo/spring",
            "url_pc": "https://www.example.com/promo/spring"
          },
          {
            "name": "앱에서 보기",
            "type": "AL",
            "linkMo": "https://m.example.com/app",
            "linkAnd": "example://promo/spring",
            "linkIos": "example://promo/spring"
          }
        ],
      "fbInfoLst": [
        {
          "ch": "SMS",
          "title": "제목",
          "msg": "SMS 메시지 내용"
        }
       ]
      }

와이드아이템리스트형

curl -X POST "https://api.msghub.uplus.co.kr/msg/v1.2/friendtalk" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
          "clickUrlYn": "N",
          "resvYn": "N",
          "callback": "0212345678",
          "resvReqDt": "2025-07-13 13:15",
          "agency": {
            "kisaOrigCode": "123456789"
          },
          "kkoChId": "@카카오채널",
          "recvInfoLst": [
            {
              "cliKey": "test001",
              "phone": "01012341234",
              "mergeData": {
                "item1": "1",
                "item2": "2",
                "item3": "3",
                "item4": "4",
                "헤더": " 헤더"
              }
            }
          ],
          "adFlag": "Y",
          "header": "#{헤더} 헤더",
          "msg": "#{헤더} 헤더",
          "item": [
            {
              "title": "#{item1} 아이템1",
              "imgUrl": "https://mud-kage.kakao.com/dn/VMJON/btsJA3S4sTz/XefT6j2dkL9Gmax8e6nEe0/img_l.jpg",
              "linkMo": "https://naver.com",
              "linkPc": "",
              "linkAnd": "",
              "linkIos": ""
            },
            {
              "title": "#{item2} 아이템2",
              "imgUrl": "https://mud-kage.kakao.com/dn/gYgR7/btsLfnB4ArJ/LLuYkwnVxMowZDlOxZAnbK/img_l.jpg",
              "linkMo": "https://naver.com",
              "linkPc": "",
              "linkAnd": "",
              "linkIos": ""
            },
            {
              "title": "#{item3} 아이템3",
              "imgUrl": "https://mud-kage.kakao.com/dn/ceMzhh/btsL8dsjdWP/OrJnobHrU3OoKMTrcbQ4fK/img_l.jpg",
              "linkMo": "https://naver.com",
              "linkPc": "",
              "linkAnd": "",
              "linkIos": ""
            },
            {
              "title": "#{item4} 아이템4",
              "imgUrl": "https://mud-kage.kakao.com/dn/bCTIzG/btr5d3cXuQC/IYLcGjdg7PmDvXTEu2n9ik/img_l.jpg",
              "linkMo": "https://naver.com",
              "linkPc": "",
              "linkAnd": "",
              "linkIos": ""
            }
          ],
          "fbInfoLst": [
            {
              "ch": "SMS",
              "title": "제목",
              "msg": "SMS 메시지 내용"
            }
          ]
        }

캐러셀 피드형

curl -X POST "https://api.msghub.uplus.co.kr/msg/v1.2/friendtalk" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
        "clickUrlYn": "N",
        "resvYn": "N",
        "callback": "0212345678",
        "resvReqDt": "2025-07-13 13:15",
        "agency": {
          "kisaOrigCode": "123456789"
        },
        "adFlag": "Y",
        "kkoChId": "@카카오채널",
        "msg": "msg 내용",
        "recvInfoLst": [
          {
            "cliKey": "test0001",
            "phone": "01012341234",
            "mergeData": {
              "name": "변수내용"
            }
          }
        ],
        "carousel": {
          "list": [
            {
              "header": "캐러셀 제목",
              "message": "캐러셀 내용 {name}",
              "attachment": {
                "image": {
                  "imgUrl": "https://mud-kage.kakao.com/.../example.jpg"
                },
                "button": [
                  {
                    "name": "연결하기",
                    "linkType": "WL",
                    "linkMo": "http://m.example.com",
                    "linkPc": "http://www.example.com"
                  }
                ]
              }
            },
            {
              "header": "캐러셀 제목",
              "message": "캐러셀 내용",
              "attachment": {
                "image": {
                  "imgUrl": "https://mud-kage.kakao.com/.../example.jpg"
                },
                 "button": [
                  {
                    "name": "연결하기",
                    "linkType": "WL",
                    "linkMo": "http://m.example.com",
                    "linkPc": "http://www.example.com"
                  }
                ]
              }
            }
          ],
          "tail": {
            "linkMo": "http://m.example.com",
            "linkPc": "http://www.example.com"
          }
        }
      }

프리미엄 동영상형

curl -X POST "https://api.msghub.uplus.co.kr/msg/v1.2/friendtalk" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
        "clickUrlYn": "N",
        "resvYn": "N",
        "callback": "0212345678",
        "resvReqDt": "2025-07-13 13:15",
        "agency": {
          "kisaOrigCode": "123456789"
        },
        "kkoChId": "@카카오채널",
        "msg": "msg 내용",
        "recvInfoLst": [
          {
            "cliKey": "test0001",
            "phone": "01012341234",
            "mergeData": {
              "name": "변수내용"
            }
          }
        ],
        "video": {
          "videoUrl": "https://tv.kakao.com/channel/.../cliplink/...",
          "thumbnailUrl": "https://mud-kage.kakao.com/dn/..../img_l.jpg"
        }
       "adFlag": "N"
    }

커머스형

curl -X POST "https://api.msghub.uplus.co.kr/msg/v1.2/friendtalk" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
        "clickUrlYn": "N",
        "resvYn": "N",
        "callback": "0212345678",
        "resvReqDt": "2025-07-13 13:15",
        "agency": {
          "kisaOrigCode": "123456789"
        },
        "kkoChId": "@카카오채널",
        "msg": "msg 내용",
        "recvInfoLst": [
          {
            "cliKey": "test0001",
            "phone": "01012341234",
            "mergeData": {
              "name": "변수내용"
            }
          }
        ],
        "additionalContent": "부가정보",
        "commerce": {
           "title": "커머스형 제목",
           "regular_price": 가격
        },
        "image": {
          "imgUrl": "https://mud-kage.kakao.com/dn/Skp61/btsNFhtwYlG/PQ9JKL4V9XhLxjtWCHXuTK/img_l.jpg",
          "imgLink": ""
        },
        "buttons": [
          {
            "name": "연결하기",
            "linkType": "WL",
            "linkMo": "http://m.naver.com",
            "linkPc": "http://www.naver.com",
            "linkAnd": "",
            "linkIos": ""
          }
        ],
        "adFlag": "N"
      }

캐러셀커머스형

curl -X POST "https://api.msghub.uplus.co.kr/msg/v1.2/friendtalk" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
        "clickUrlYn": "N",
        "resvYn": "N",
        "callback": "0212345678",
        "resvReqDt": "2025-07-13 13:15",
        "agency": {
          "kisaOrigCode": "123456789"
        },
          "kkoChId": "@카카오채널",
          "msg": "msg 내용",
          "recvInfoLst": [
            {
              "cliKey": "test0001",
              "phone": "01012341234",
              "mergeData": {
                "name": "변수내용"
              }
            }
          ],
          "carouselCommerce": {
            "head": {
              "header": "캐러셀 헤더",
              "content": "캐러셀 인트로 내용",
              "imageUrl": "https://mud-kage.kakao.com/dn/.../img_l.jpg",
              "linkMo": "http://www.naver.com"
            },
            "list": [
              {
                "additionalContent": "부가정보 작성란",
                "attachment": {
                  "button": [
                    {
                      "name": "버튼1",
                      "type": "WL",
                      "linkMo": "http://www.naver.com",
                      "linkPc": "http://www.naver.com"
                    }
                  ],
                  "image": {
                    "imgUrl": "https://mud-kage.kakao.com/dn/.../img_l.jpg",
                    "imgLink": "http://m.naver.com"
                  },
                  "commerce": {
                    "title": "커머스2",
                    "regular_price": 2222
                  }
                }
              },
              {
                "additionalContent": "부가정보2",
                "attachment": {
                  "button": [
                    {
                      "name": "버튼2",
                      "type": "WL",
                      "linkMo": "http://www.naver.com",
                      "linkPc": "http://www.naver.com"
                    }
                  ],
                  "image": {
                    "imgUrl": "https://mud-kage.kakao.com/dn/..../img_l.jpg",
                    "imgLink": "http://m.naver.com"
                  },
                  "commerce": {
                    "title": "커머스2",
                    "regular_price": 1111
                  }
                }
              }
            ],
            "tail": {
              "linkMo": "http://sms.uplus.co.kr"
            }
          },
          "adFlag": "N"
      }

Response

{
  "code": "10000",
  "message": "성공",
  "data": [
    {
      "cliKey": "test001",
      "msgKey": "3jVnyk0m8U.6fKG1w",
      "phone": "01012341234",
      "code": "10000",
      "message": "성공"
    },
    ...
  ]
}

Appendix

Agency 객체

대행사 정보를 포함하는 객체입니다.

필드명	타입	필수	설명
kisaOrigCode	String	-	재판매사 KISA 최초식별코드

recvInfoLst 객체

Name	Type	필수	설명	크기
cliKey	String	●	클라이언트키	30자
phone	String	●	수신번호(국제문자 발송 시 맨 앞에 ‘0’이 없어야함)	20자
mergeData	Object	-	채널별 개별화메시지 머지데이터	-

fbInfoLst 객체

Name	Type	필수	설명
ch	String	●	채널
title	String	-	제목(MMS의 경우 필수)
msg	String	●	메시지
fileId	String	-	파일아이디 (파일 아이디와 파일 아이디 목록 중 1개만 사용 가능)
fileIdLst	Array	-	파일 아이디 목록 (최대 3개)

결과 코드

결과 코드

2.4 카카오톡 메시지

목차

1. 알림톡 발송 V1.2

📌 주의사항

📌 버튼 타입 설명

1) 요청 (Request)

URL

Headers

Request Body

item 객체

buttons 객체

2) 응답 (Response)

Response Body

3) 요청 예시 (Sample)

Curl

아이템리스트형 이외의 템플릿

아이템리스트형 템플릿

Response

2. 친구톡 발송 V1.2

📌 주의사항

📌 버튼 타입 설명

1) 요청 (Request)

URL

Headers

Request Body

image 객체

item 객체

carousel 객체

coupon 객체

video 객체

buttons 객체

2) 응답 (Response)

Response Body

3) 요청 예시 (Sample)

💡 Json 예시

텍스트형

텍스트+이미지형

와이드아이템리스트형

캐러셀 피드형

프리미엄 동영상형

커머스형

캐러셀커머스형

Response

Appendix

Agency 객체

recvInfoLst 객체

fbInfoLst 객체

결과 코드