4.2 카카오 통계

목차

• 1. 카카오 채널의 알림톡 읽음 통계 조회
• 2. 카카오 채널의 브랜드메시지 읽음 통계 조회
• 3. 카카오 채널의 브랜드메시지 클릭 통계 조회
• 4. 카카오 채널 템플릿별 알림톡 읽음 통계 조회
• 5. 카카오 채널 템플릿별 브랜드메시지 읽음 통계 조회
• 6. 카카오 채널 템플릿별 알림톡 버튼 통계 조회
• 7. 카카오 채널 템플릿별 브랜드메시지 클릭 통계 조회
• Appendix

베이스 URL

구분	접속 URL
상용	https://mnt-api.msghub.uplus.co.kr
검수	https://mnt-api.msghub-qa.uplus.co.kr

1. 카카오 채널의 알림톡 읽음 통계 조회

카카오 채널의 알림톡 읽음 통계를 조회합니다. 메시지 타입·수신자 유형별 유효 읽음 수를 확인할 수 있습니다.

---

1) 요청 (Request)

URL

GET /kko/v2/stat/kkoChId/alimtalkRead HTTP/1.1

Headers

필드명	타입	필수 여부	설명
Authorization	String	●	사용자 인증 토큰
Content-Type	String	●	application/json

Query Parameters

필드명	타입	필수 여부	설명	크기
kkoChId	String	●	카카오채널 아이디 (예: @메시지허브)	61자
date	String	●	조회일(발송일) (yyyyMMdd)	8자
elapsedDay	String	●	조회일 기준 경과일수 (0~2)	1자

---

2) 응답 (Response)

Response Body

필드명	타입	설명
code	String	결과 코드
message	String	결과 메시지
data[]	Array	읽음 통계 목록
data[].date	String	조회일(발송일) (yyyyMMdd)
data[].kkoChId	String	카카오채널 아이디
data[].messageType	String	메시지 타입 (AT: 알림톡, AI: 이미지 알림톡)
data[].receiveUserType	String	수신자 유형 (PhoneNumber: 전화번호, AppUserId: 앱유저아이디, UserKey: 유저키, None: 잘못된 수신자 정보)
data[].readCount	Integer	유효 읽음 수

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://mnt-api.msghub.uplus.co.kr/kko/v2/stat/kkoChId/alimtalkRead?kkoChId=@메시지허브&date=20250710&elapsedDay=0" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}"

JSON Response

{
  "code": "10000",
  "message": "성공",
  "data": [
    {
      "date": "20250710",
      "kkoChId": "@메시지허브",
      "messageType": "AT",
      "receiveUserType": "PhoneNumber",
      "readCount": 120
    },
    {
      "date": "20250710",
      "kkoChId": "@메시지허브",
      "messageType": "AI",
      "receiveUserType": "PhoneNumber",
      "readCount": 35
    }
  ]
}

2. 카카오 채널의 브랜드메시지 읽음 통계 조회

카카오 채널의 브랜드메시지 읽음 통계를 조회합니다. 발송 타입·메시지 타입·타게팅·친구 유형별 유효 읽음 수를 확인할 수 있습니다.

---

1) 요청 (Request)

URL

GET /kko/v2/stat/kkoChId/brandtalkRead HTTP/1.1

Headers

필드명	타입	필수 여부	설명
Authorization	String	●	사용자 인증 토큰
Content-Type	String	●	application/json

Query Parameters

필드명	타입	필수 여부	설명	크기
kkoChId	String	●	카카오채널 아이디 (예: @메시지허브)	61자
date	String	●	조회일(발송일) (yyyyMMdd)	8자
elapsedDay	String	●	조회일 기준 경과일수 (0~2)	1자

---

2) 응답 (Response)

Response Body

필드명	타입	설명
code	String	결과 코드
message	String	결과 메시지
data[]	Array	읽음 통계 목록
data[].date	String	조회일(발송일) (yyyyMMdd)
data[].kkoChId	String	카카오채널 아이디
data[].messageSpec	String	발송 타입 (BASIC: 템플릿형, FREESTYLE: 자유형)
data[].chatBubbleType	String	메시지 타입 (TEXT, IMAGE, WIDE, WIDE_ITEM_LIST, CAROUSEL_FEED, PREMIUM_VIDEO, COMMERCE, CAROUSEL_COMMERCE)
data[].receiveUserType	String	수신자 유형 (PhoneNumber: 전화번호, AppUserId: 앱유저아이디, UserKey: 유저키, None: 잘못된 수신자 정보)
data[].targeting	String	발송 타게팅
data[].friendType	String	친구 타입 (N: 비친구, F: 친구)
data[].readCount	Integer	유효 읽음 수

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://mnt-api.msghub.uplus.co.kr/kko/v2/stat/kkoChId/brandtalkRead?kkoChId=@메시지허브&date=20250710&elapsedDay=0" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}"

JSON Response

{
  "code": "10000",
  "message": "성공",
  "data": [
    {
      "date": "20250710",
      "kkoChId": "@메시지허브",
      "messageSpec": "BASIC",
      "chatBubbleType": "TEXT",
      "receiveUserType": "PhoneNumber",
      "targeting": "I",
      "friendType": "F",
      "readCount": 80
    },
    {
      "date": "20250710",
      "kkoChId": "@메시지허브",
      "messageSpec": "FREESTYLE",
      "chatBubbleType": "IMAGE",
      "receiveUserType": "PhoneNumber",
      "targeting": "M",
      "friendType": "F",
      "readCount": 22
    }
  ]
}

3. 카카오 채널의 브랜드메시지 클릭 통계 조회

카카오 채널의 브랜드메시지 클릭 통계를 조회합니다. 버튼·리스트·썸네일·기타 클릭 수를 확인할 수 있습니다.

---

1) 요청 (Request)

URL

GET /kko/v2/stat/kkoChId/brandtalkClick HTTP/1.1

Headers

필드명	타입	필수 여부	설명
Authorization	String	●	사용자 인증 토큰
Content-Type	String	●	application/json

Query Parameters

필드명	타입	필수 여부	설명	크기
kkoChId	String	●	카카오채널 아이디 (예: @메시지허브)	61자
date	String	●	조회일(발송일) (yyyyMMdd)	8자
elapsedDay	String	●	조회일 기준 경과일수 (0~2)	1자

---

2) 응답 (Response)

Response Body

필드명	타입	설명
code	String	결과 코드
message	String	결과 메시지
data[]	Array	버튼 클릭 통계 목록
data[].date	String	조회일(발송일) (yyyyMMdd)
data[].kkoChId	String	카카오채널 아이디
data[].messageSpec	String	발송 타입 (BASIC: 템플릿형, FREESTYLE: 자유형)
data[].chatBubbleType	String	메시지 타입 (TEXT, IMAGE, WIDE, WIDE_ITEM_LIST, CAROUSEL_FEED, PREMIUM_VIDEO, COMMERCE, CAROUSEL_COMMERCE)
data[].receiveUserType	String	수신자 유형 (PhoneNumber: 전화번호, AppUserId: 앱유저아이디, UserKey: 유저키, None: 잘못된 수신자 정보)
data[].targeting	String	발송 타게팅
data[].friendType	String	친구 타입 (N: 비친구, F: 친구)
data[].buttonClickCount	Integer	버튼 클릭 수
data[].listClickCount	Integer	리스트 클릭 수
data[].thumbnailClickCount	Integer	썸네일 클릭 수
data[].etcClickCount	Integer	이외의 항목 클릭 수

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://mnt-api.msghub.uplus.co.kr/kko/v2/stat/kkoChId/brandtalkClick?kkoChId=@메시지허브&date=20250710&elapsedDay=0" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}"

JSON Response

{
  "code": "10000",
  "message": "성공",
  "data": [
    {
      "date": "20250710",
      "kkoChId": "@메시지허브",
      "messageSpec": "BASIC",
      "chatBubbleType": "WIDE",
      "receiveUserType": "PhoneNumber",
      "targeting": "I",
      "friendType": "F",
      "buttonClickCount": 40,
      "listClickCount": 5,
      "thumbnailClickCount": 12,
      "etcClickCount": 2
    }
  ]
}

4. 카카오 채널 템플릿별 알림톡 읽음 통계 조회

카카오 채널의 알림톡 템플릿별 읽음 통계를 조회합니다. 템플릿 코드·메시지 타입별 유효 읽음 수를 확인할 수 있습니다.

---

1) 요청 (Request)

URL

GET /kko/v2/stat/template/alimtalkRead HTTP/1.1

Headers

필드명	타입	필수 여부	설명
Authorization	String	●	사용자 인증 토큰
Content-Type	String	●	application/json

Query Parameters

필드명	타입	필수 여부	설명	크기
kkoChId	String	●	카카오채널 아이디 (예: @메시지허브)	61자
date	String	●	조회일(발송일) (yyyyMMdd)	8자
elapsedDay	String	●	조회일 기준 경과일수 (0~2)	1자

---

2) 응답 (Response)

Response Body

필드명	타입	설명
code	String	결과 코드
message	String	결과 메시지
data[]	Array	읽음 통계 목록
data[].date	String	조회일(발송일) (yyyyMMdd)
data[].kkoChId	String	카카오채널 아이디
data[].messageType	String	메시지 타입 (AT: 알림톡, AI: 이미지 알림톡)
data[].templateCode	String	템플릿 코드
data[].readCount	Integer	유효 읽음 수

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://mnt-api.msghub.uplus.co.kr/kko/v2/stat/template/alimtalkRead?kkoChId=@메시지허브&date=20250710&elapsedDay=0" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}"

JSON Response

{
  "code": "10000",
  "message": "성공",
  "data": [
    {
      "date": "20250710",
      "kkoChId": "@메시지허브",
      "messageType": "AT",
      "templateCode": "TMPL_ORDER_001",
      "readCount": 95
    },
    {
      "date": "20250710",
      "kkoChId": "@메시지허브",
      "messageType": "AI",
      "templateCode": "TMPL_PROMO_002",
      "readCount": 41
    }
  ]
}

5. 카카오 채널 템플릿별 브랜드메시지 읽음 통계 조회

카카오 채널의 브랜드메시지 템플릿별 읽음 통계를 조회합니다. 템플릿 코드·그룹태그·발송 타입별 유효 읽음 수를 확인할 수 있습니다.

---

1) 요청 (Request)

URL

GET /kko/v2/stat/template/brandtalkRead HTTP/1.1

Headers

필드명	타입	필수 여부	설명
Authorization	String	●	사용자 인증 토큰
Content-Type	String	●	application/json

Query Parameters

필드명	타입	필수 여부	설명	크기
kkoChId	String	●	카카오채널 아이디 (예: @메시지허브)	61자
date	String	●	조회일(발송일) (yyyyMMdd)	8자
elapsedDay	String	●	조회일 기준 경과일수 (0~2)	1자

---

2) 응답 (Response)

Response Body

필드명	타입	설명
code	String	결과 코드
message	String	결과 메시지
data[]	Array	읽음 통계 목록
data[].date	String	조회일(발송일) (yyyyMMdd)
data[].kkoChId	String	카카오채널 아이디
data[].templateCode	String	템플릿 코드
data[].groupTagKey	String	그룹 태그 키
data[].messageSpec	String	발송 타입 (BASIC: 템플릿형, FREESTYLE: 자유형)
data[].chatBubbleType	String	메시지 타입 (TEXT, IMAGE, WIDE, WIDE_ITEM_LIST, CAROUSEL_FEED, PREMIUM_VIDEO, COMMERCE, CAROUSEL_COMMERCE)
data[].targeting	String	발송 타게팅
data[].friendType	String	친구 타입 (N: 비친구, F: 친구)
data[].readCount	Integer	유효 읽음 수

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://mnt-api.msghub.uplus.co.kr/kko/v2/stat/template/brandtalkRead?kkoChId=@메시지허브&date=20250710&elapsedDay=0" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}"

JSON Response

{
  "code": "10000",
  "message": "성공",
  "data": [
    {
      "date": "20250710",
      "kkoChId": "@메시지허브",
      "templateCode": "BM_TMPL_001",
      "groupTagKey": "GRP_TAG_01",
      "messageSpec": "BASIC",
      "chatBubbleType": "TEXT",
      "targeting": "I",
      "friendType": "F",
      "readCount": 60
    }
  ]
}

6. 카카오 채널 템플릿별 알림톡 클릭 통계 조회

카카오 채널의 알림톡 템플릿별 클릭 통계를 조회합니다. 버튼 순서·유형·바로연결 유형별 클릭 상세 정보를 확인할 수 있습니다.

---

1) 요청 (Request)

URL

GET /kko/v2/stat/template/alimtalkClick HTTP/1.1

Headers

필드명	타입	필수 여부	설명
Authorization	String	●	사용자 인증 토큰
Content-Type	String	●	application/json

Query Parameters

필드명	타입	필수 여부	설명	크기
kkoChId	String	●	카카오채널 아이디 (예: @메시지허브)	61자
date	String	●	조회일(발송일) (yyyyMMdd)	8자
elapsedDay	String	●	조회일 기준 경과일수 (0~2)	1자

---

2) 응답 (Response)

Response Body

필드명	타입	설명
code	String	결과 코드
message	String	결과 메시지
data[]	Array	버튼 클릭 통계 목록
data[].date	String	조회일(발송일) (yyyyMMdd)
data[].kkoChId	String	카카오채널 아이디
data[].templateCode	String	템플릿 코드
data[].messageType	String	메시지 타입 (AT: 알림톡, AI: 이미지 알림톡)
data[].clickInfo	Object	클릭 상세 정보
data[].clickInfo.buttonOrders	Array	버튼 순서별 클릭 수
data[].clickInfo.buttonType	Json	버튼 유형별 클릭 수 (예: WL, AL, DS, MD)
data[].clickInfo.qrType	Json	바로연결 유형별 클릭 수 (예: WL, AL, DS, MD)
data[].clickInfo.etc	Integer	순서/타입 집계에 포함되지 않는 링크 클릭 요소 합계

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://mnt-api.msghub.uplus.co.kr/kko/v2/stat/template/alimtalkClick?kkoChId=@메시지허브&date=20250710&elapsedDay=0" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}"

JSON Response

{
  "code": "10000",
  "message": "성공",
  "data": [
    {
      "date": "20250710",
      "kkoChId": "@메시지허브",
      "templateCode": "TMPL_ORDER_001",
      "messageType": "AT",
      "clickInfo": {
        "buttonOrders": [10, 5, 2],
        "buttonType": {
          "WL": 8,
          "AL": 6,
          "DS": 3
        },
        "qrType": {
          "WL": 4,
          "MD": 1
        },
        "etc": 2
      }
    }
  ]
}

7. 카카오 채널 템플릿별 브랜드메시지 클릭 통계 조회

카카오 채널의 브랜드메시지 템플릿별 클릭 통계를 조회합니다. 버튼·이미지·리스트 순서별 클릭 상세 정보를 확인할 수 있습니다.

---

1) 요청 (Request)

URL

GET /kko/v2/stat/template/brandtalkClick HTTP/1.1

Headers

필드명	타입	필수 여부	설명
Authorization	String	●	사용자 인증 토큰
Content-Type	String	●	application/json

Query Parameters

필드명	타입	필수 여부	설명	크기
kkoChId	String	●	카카오채널 아이디 (예: @메시지허브)	61자
date	String	●	조회일(발송일) (yyyyMMdd)	8자
elapsedDay	String	●	조회일 기준 경과일수 (0~2)	1자

---

2) 응답 (Response)

Response Body

필드명	타입	설명
code	String	결과 코드
message	String	결과 메시지
data[]	Array	버튼 클릭 통계 목록
data[].date	String	조회일(발송일) (yyyyMMdd)
data[].kkoChId	String	카카오채널 아이디
data[].templateCode	String	템플릿 코드
data[].groupTagKey	String	그룹 태그 키
data[].messageSpec	String	발송 타입 (BASIC: 템플릿형, FREESTYLE: 자유형)
data[].chatBubbleType	String	메시지 타입 (TEXT, IMAGE, WIDE, WIDE_ITEM_LIST, CAROUSEL_FEED, PREMIUM_VIDEO, COMMERCE, CAROUSEL_COMMERCE)
data[].targeting	String	발송 타게팅
data[].friendType	String	친구 타입 (N: 비친구, F: 친구)
data[].clickInfo	Object	클릭 상세 정보
data[].clickInfo.buttonOrders	Array	버튼 순서별 클릭 수
data[].clickInfo.imageOrders	Array	이미지 순서별 클릭 수
data[].clickInfo.listOrders	Array	리스트 순서별 클릭 수
data[].clickInfo.etc	Integer	그 외 항목 클릭 수

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://mnt-api.msghub.uplus.co.kr/kko/v2/stat/template/brandtalkClick?kkoChId=@메시지허브&date=20250710&elapsedDay=0" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}"

JSON Response

{
  "code": "10000",
  "message": "성공",
  "data": [
    {
      "date": "20250710",
      "kkoChId": "@메시지허브",
      "templateCode": "BM_TMPL_001",
      "groupTagKey": "GRP_TAG_01",
      "messageSpec": "BASIC",
      "chatBubbleType": "WIDE_ITEM_LIST",
      "targeting": "I",
      "friendType": "F",
      "clickInfo": {
        "buttonOrders": [15, 7],
        "imageOrders": [9, 3],
        "listOrders": [4, 2, 1],
        "etc": 1
      }
    }
  ]
}

Appendix

결과 코드

• 결과 코드