array<object>
O
일자별, 대화방별 브랜드 프로필 노출 통계 Data
code
string
5
O
20000000
status
integer
3
O
200
desc
string
O
statDate
string
8
통계일자
chatbotId
string
15
대화방 ID
displayedCount
integer
대화방별 브랜드 프로필 노출 건수
{
"code": "20000000",
"desc": null,
"result": [
{
"statDate": "20240630",
"chatbotId": "09044196572",
"displayedCount": 620
},
{
"statDate": "20240629",
"chatbotId": "09044196572",
"displayedCount": 636
},
{
"statDate": "20240628",
"chatbotId": "09044196572",
"displayedCount": 631
},
{
"statDate": "20240627",
"chatbotId": "09044196572",
"displayedCount": 632
},
{
"statDate": "20240626",
"chatbotId": "09044196572",
"displayedCount": 609
},
{
"statDate": "20240625",
"chatbotId": "09044196572",
"displayedCount": 639
}
],
"status": 200
}{
"error": {
"code": "64002",
"message": "Invalid Brand Key"
},
"status": 400
}
{
"error": {
"code": "64203",
"message": "query paramter required [chatbotId]"
},
"status": 400
}
{
"error": {
"code": "64203",
"message": "query paramter required [endDate]"
},
"status": 400
}
{
"error": {
"code": "64338",
"message": "invalid value: [endDate], endDate must be within 31 days"
},
"status": 400
}{
"error": {
"code": "61003",
"message": "Invalid token"
},
"status": 401
}{
"error": {
"code": "63001",
"message": "No Brand Permission"
},
"status": 403
}error code는 RCS Biz Center - Response body error code 참조
array<object>
O
메시지 버튼 클릭 카운트
code
string
5
O
20000000
status
integer
3
O
200
desc
string
O
statDate
string
8
통계일자
corpId
string
13
RCS Biz Center에 등록된 기업ID
corpRegNum
string
10
기업사업자 등록 번호
brandId
string
13
브랜드 ID
chatbotId
string
15
대화방 ID
groupId
string
20
발송 캠페인 구분 ID
messagebaseId
string
40
NA
발송 메시지의 messagebaseId
reactionType
string
20
NA
고객이 클릭 반응한 대상(
cardNum
string
고객이 클릭 반응한 대상
array<object>
발송 캠페인 메시지에 포함된 RCS 액션 버튼 통계 Data
buttonNum
string
0
이미지, 칩리스트 또는 버튼 reactionType별 메시지 내 위치를 나타내는 번호(식별 불가시 0)
좌에서 우, 위에서 아래로 1부터 번호 부여하며 Carousel은 각 카드별로 1부터 부여
actionType
string
메시지 버튼에 할당된 RCS 액션 유형 이미지 영역에 동영상 스트리밍을 설정한 경우 iframeplayB로 별도 구분
title
string
40
버튼명, 이미지는 image_1, image_2, ..., image_# 형식으로 제공되며, 동영상 스트리밍의 경우는 iframeplayB_1, iframeplayB_2, ..., iframeplayB_# 형식으로 제공
clickCount
integer
버튼 클릭수 (1일 내 동일 고객의 버튼 클릭 수 제외)
{
"code": "20000000",
"desc": null,
"result": [
{
"statDate": "20240629",
"corpId": "CO.NoI0czCZ64",
"corpRegNum": "8632573324",
"brandId": "BR.mp0Xf8sGBE",
"chatbotId": "09044196572",
"groupId": "6236",
"messagebaseId": "IBR.mp0Xf8sGBE-iE8w82N11u45AHjEC3Oz8CB9A",
"cardNum": 1,
"reactionType": "button",
"buttonList": [
{
"actionType": "urlAction",
"title": "자세히 보기",
"clickCount": 272,
"buttonNum": 1
},
{
"actionType": "urlAction",
"title": "버닝러시",
"clickCount": 82,
"buttonNum": 2
}
]
},
{
"statDate": "20240629",
"corpId": "CO.NoI0czCZ64",
"corpRegNum": "8632573324",
"brandId": "BR.mp0Xf8sGBE",
"chatbotId": "09044196572",
"groupId": "6236",
"messagebaseId": "IBR.mp0Xf8sGBE-iE8w82N11u45AHjEC3Oz8CB9A",
"cardNum": 1,
"reactionType": "image",
"buttonList": [
{
"actionType": "urlAction",
"title": "image_1",
"clickCount": 32,
"buttonNum": 1
}
]
}
],
"status": 200
}{
"error": {
"code": "64002",
"message": "Invalid Brand Key"
},
"status": 400
}
{
"error": {
"code": "64203",
"message": "query paramter required [groupId]"
},
"status": 400
}
{
"error": {
"code": "64203",
"message": "query paramter required [endDate]"
},
"status": 400
}
{
"error": {
"code": "64338",
"message": "invalid value: [endDate], endDate must be within 31 days"
},
"status": 400
}{
"error": {
"code": "61003",
"message": "Invalid token"
},
"status": 401
}{
"error": {
"code": "63001",
"message": "No Brand Permission"
},
"status": 403
}error code는 RCS Biz Center - Response body error code 참조
이 문서는 고객 통계 데이터에 대한 API 정보를 안내합니다.
array<object>
O
메시지 발송 읽음 확인 통계 Data
code
string
5
O
20000000
status
integer
3
O
200
desc
string
O
statDate
string
8
통계일자
corpId
string
13
RCS Biz Center에 등록된 기업ID
corpRegNum
string
10
기업사업자 등록 번호
brandId
string
13
브랜드 ID
chatbotId
string
15
대화방 ID
groupId
string
20
발송 캠페인 구분 ID
messagebaseId
string
40
발송 메시지의 messagebaseId(식별 불가시 NA)
deliveredCount
integer
발송 건수
displayedCount
integer
읽음확인 건수
{
"code": "20000000",
"desc": null,
"result": [
{
"statDate": "20240628",
"corpId": "CO.NoI0czCZ64",
"corpRegNum": "8632573324",
"brandId": "BR.mp0Xf8sGBE",
"chatbotId": "09044196572",
"groupId": "6227",
"messagebaseId": "SMwThT00",
"deliveredCount": 116,
"displayedCount": 56
},
{
"statDate": "20240629",
"corpId": "CO.NoI0czCZ64",
"corpRegNum": "8632573324",
"brandId": "BR.mp0Xf8sGBE",
"chatbotId": "09044196572",
"groupId": "6227",
"messagebaseId": "SMwThT00",
"deliveredCount": 0,
"displayedCount": 9
}
],
"status": 200
}{
"error": {
"code": "64002",
"message": "Invalid Brand Key"
},
"status": 400
}
{
"error": {
"code": "64203",
"message": "query paramter required [groupId]"
},
"status": 400
}
{
"error": {
"code": "64203",
"message": "query paramter required [endDate]"
},
"status": 400
}
{
"error": {
"code": "64338",
"message": "invalid value: [endDate], endDate must be within 31 days"
},
"status": 400
}{
"error": {
"code": "61003",
"message": "Invalid token"
},
"status": 401
}{
"error": {
"code": "63001",
"message": "No Brand Permission"
},
"status": 403
}error code는 RCS Biz Center - Response body error code 참조
array<object>
O
대화방메뉴 통계 Data
code
string
5
O
20000000
status
integer
3
O
200
desc
string
O
statDate
string
8
통계일자
corpId
string
13
RCS Biz Center에 등록된 기업ID
corpRegNum
string
10
기업사업자 등록 번호
brandId
string
13
브랜드 ID
chatbotId
string
15
대화방 ID
array<object>
대화방메뉴 별 상세 Data
postbackId
string
40
O
메뉴에 할당된 postbackId
menuType
string
40
O
메뉴 할당된 액션 구분
action: RCS 액션 버튼(urlAction, mapAction, ...) 메뉴
reply: 기본응답 메뉴
autoreply: 자동응답 메뉴
menu: 하위 메뉴를 갖는 상위 메뉴
actionType
string
menuType이 action인 경우 할당된 RCS 액션 유형 이미지 영역에 동영상 스트리밍을 설정한 경우 iframeplayB로 별도 구분(현재 자동응답메시지는 iframepalyB 설정 미지원)
title
string
40
O
버튼명, 이미지는 image_1, image_2, ..., image_# 형식으로 제공되며, 동영상 스트리밍의 경우는 iframeplayB_1, iframeplayB_2, ..., iframeplayB_# 형식으로 제공
clickCount
integer
menuType이 action, reply, autoreply 인 경우 클릭수 (1일 내 동일 고객의 버튼 클릭 수 제외)
array<object>
하위 메뉴 또는 자동응답메시지 상의 버튼 상세 Data
postbackId
string
40
O
메뉴에 할당된 postbackId
menuType
string
40
O
메뉴 할당된 액션 구분
action: RCS 액션 버튼(urlAction, mapAction, ...) 메뉴
reply: 기본응답 메뉴
autoreply: 자동응답 메뉴
menu: 하위 메뉴를 갖는 상위 메뉴
actionType
string
menuType이 action인 경우 할당된 RCS 액션 유형 이미지 영역에 동영상 스트리밍을 설정한 경우 iframeplayB로 별도 구분(현재 자동응답메시지는 iframepalyB 설정 미지원)
title
string
40
O
버튼명, 이미지는 image_1, image_2, ..., image_# 형식으로 제공되며, 동영상 스트리밍의 경우는 iframeplayB_1, iframeplayB_2, ..., iframeplayB_# 형식으로 제공
clickCount
integer
menuType이 action, reply, autoreply 인 경우 클릭수 (1일 내 동일 고객의 버튼 클릭 수 제외)
array<object>
menuType이 autoReply인 경우 자동응답메시지 상의 상세 버튼 Data
postbackId
string
40
O
메뉴에 할당된 postbackId
actionType
string
menuType이 action인 경우 할당된 RCS 액션 유형 이미지 영역에 동영상 스트리밍을 설정한 경우 iframeplayB로 별도 구분(현재 자동응답메시지는 iframepalyB 설정 미지원)
title
string
40
O
버튼명, 이미지는 image_1, image_2, ..., image_# 형식으로 제공되며, 동영상 스트리밍의 경우는 iframeplayB_1, iframeplayB_2, ..., iframeplayB_# 형식으로 제공
clickCount
integer
menuType이 action, reply, autoreply 인 경우 클릭수 (1일 내 동일 고객의 버튼 클릭 수 제외)
{
"code": "20000000",
"desc": null,
"result": [
{
"statDate": "20240630",
"corpId": "CO.NoI0czCZ64",
"corpRegNum": "8632573324",
"brandId": "BR.mp0Xf8sGBE",
"chatbotId": "09044196573",
"menuList": [
{
"postbackId": "P090pbJY06J6fgX",
"menuType": "autoreply",
"title": "내원 진료 시간",
"clickCount": 1
},
{
"postbackId": "ARM6J1wfCn81N6u",
"menuType": "autoreply",
"title": "위치 안내",
"clickCount": 1,
"subList": [
{
"postbackId": "Pec587X6nVY8k5c",
"menuType": "action",
"title": "지도",
"clickCount": 1,
"actionType": "urlAction",
"messagebaseId": "SCwThT00",
"reactionType": "button",
"cardNum": 1,
"buttonNum": 1
}
]
}
]
},
{
"statDate": "20240629",
"corpId": "CO.NoI0czCZ64",
"corpRegNum": "8632573324",
"brandId": "BR.mp0Xf8sGBE",
"chatbotId": "09044196573",
"menuList": [
{
"postbackId": "ARM6J1wfCn81N6u",
"menuType": "autoreply",
"title": "위치 안내",
"clickCount": 1,
"subList": [
{
"postbackId": "Pec587X6nVY8k5c",
"menuType": "action",
"title": "지도",
"clickCount": 1,
"actionType": "urlAction",
"messagebaseId": "SCwThT00",
"reactionType": "button",
"cardNum": 1,
"buttonNum": 1
}
]
}
]
},
{
"statDate": "20240628",
"corpId": "CO.NoI0czCZ64",
"corpRegNum": "8632573324",
"brandId": "BR.mp0Xf8sGBE",
"chatbotId": "09044196573",
"menuList": [
{
"postbackId": "P41aj0w7FTu97Zw",
"menuType": "autoreply",
"title": "국민건강보험공단 검진 안내",
"clickCount": 2
},
{
"postbackId": "ARM6J1wfCn81N6u",
"menuType": "autoreply",
"title": "위치 안내",
"clickCount": 1
}
]
}
],
"status": 200
}{
"error": {
"code": "64002",
"message": "Invalid Brand Key"
},
"status": 400
}
{
"error": {
"code": "64203",
"message": "query paramter required [chatbotId]"
},
"status": 400
}
{
"error": {
"code": "64203",
"message": "query paramter required [endDate]"
},
"status": 400
}
{
"error": {
"code": "64338",
"message": "invalid value: [endDate], endDate must be within 31 days"
},
"status": 400
}{
"error": {
"code": "61003",
"message": "Invalid token"
},
"status": 401
}{
"error": {
"code": "61003",
"message": "Invalid token"
},
"status": 401
}브랜드프로필 노출 통계를 조회합니다.
maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.
통계 조회 기간 시작일자(yyyymmdd) 입니다.
통계 조회 기간 종료일자(yyyymmdd) 입니다.
maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.
대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다. 따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.
GET /api/1.1/statQuery/brandprofile/{brandId} HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer JWT
Accept: */*
고객반응 통계 - 대화방 메뉴 클릭 통계를 조회합니다.
maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.
통계 조회 기간 시작일자(yyyymmdd) 입니다.
통계 조회 기간 종료일자(yyyymmdd) 입니다.
발송 캠페인 구분 ID 입니다.
대화방ID Query Parameter 입니다.
maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.
대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다. 따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.
GET /api/1.1/statQuery/persistentMenu/{brandId} HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer JWT
Accept: */*
고객반응 통계 - 캠페인 메시지 발송/읽음확인 통계를 조회합니다.
maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.
통계 조회 기간 시작일자(yyyymmdd) 입니다.
통계 조회 기간 종료일자(yyyymmdd) 입니다.
발송 캠페인 구분 ID 입니다.
대화방ID Query Parameter 입니다.
maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.
대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다. 따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.
GET /api/1.1/statQuery/message/{brandId} HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer JWT
Accept: */*
고객반응 통계 - 캠페인 메시지 버튼 클릭 통계를 조회합니다.
maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.
통계 조회 기간 시작일자(yyyymmdd) 입니다.
통계 조회 기간 종료일자(yyyymmdd) 입니다.
발송 캠페인 구분 ID 입니다.
대화방ID Query Parameter 입니다.
maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.
대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다. 따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.
GET /api/1.1/statQuery/messageButton/{brandId} HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer JWT
Accept: */*