안녕하세요.
비즈고 omni API로 알림톡·브랜드메시지를 발송하는 서비스를 개발 중입니다. 발송은 정상인데 읽음(오픈)·버튼클릭 통계만 계속 0으로 와서 문의드립니다.
영업 담당자분을 통해 문의드렸더니 실호출 전문을 첨부해 달라고 하셔서, 2026-08-31에 운영 서버에서 직접 호출한 요청·응답을 그대로 올립니다.
환경
- BASE: https://mars.ibapi.kr / 인증 정상(authCode: A000)
- 발신프로필(senderKey) 단위 조회. 아래 전문의 senderKey는 f851957d…로 가렸습니다(40자)
- 알림톡 통계 조회 — successCount는 맞는데 readCount만 0
GET /api/comm/v1/center/statistics/alimtalk?senderKey=f851957d…&startDate=20260820&endDate=20260826
{“common”:{“authCode”:“A000”,“infobankTrId”:“M-260831121814041PRD42375”,“authResult”:“SUCCESS”},
“data”:{“code”:“A000”,“result”:“Success”,“data”:{“statistics”:[
{“successCount”:14,“failCount”:1,“readCount”:0,“buttonClickCount”:0,“listClickCount”:0,
“thumbnailClickCount”:0,“etcClickCount”:0,“sendRate”:93.3,“readRate”:0.0,“clickRate”:0.0,“ctr”:0.0}]}}}
successCount 14 · failCount 1 · sendRate 93.3은 저희 DB 발송 기록과 정확히 일치합니다. readCount·readRate·buttonClickCount만 0입니다.
- 템플릿별 조회 — 동일
GET /api/comm/v1/center/statistics/alimtalk/template?senderKey=f851957d…&startDate=20260820&endDate=20260826
{“common”:{“authCode”:“A000”,“infobankTrId”:“M-260831121814120PRD42376”,“authResult”:“SUCCESS”},
“data”:{“code”:“A000”,“result”:“Success”,“data”:{“statistics”:[
{“templateCode”:“PH2_00576534”,“templateName”:“마운자로 채널추가2”,
“successCount”:14,“failCount”:1,“readCount”:0,“buttonClickCount”:0,“listClickCount”:0,
“thumbnailClickCount”:0,“etcClickCount”:0,“sendRate”:93.3,“readRate”:0.0,“clickRate”:0.0,“ctr”:0.0}]}}}
이 템플릿은 정상 등록·승인(APR) 된 템플릿이고, 이 발신프로필로 실제 발송된 건입니다.
- 시간별 반응 조회 — 동일
GET /api/comm/v1/center/statistics/alimtalk/reaction/hourly?senderKey=f851957d…&startDate=20260820&endDate=20260826
{“common”:{“authCode”:“A000”,“infobankTrId”:“M-260831121814218PRD99467”,“authResult”:“SUCCESS”},
“data”:{“code”:“A000”,“result”:“Success”,“data”:{“statistics”:[
{“hour”:“10”,“successCount”:1,“failCount”:0,“readCount”:0,“buttonClickCount”:0,
“sendRate”:100.0,“readRate”:0.0,“clickRate”:0.0,“ctr”:0.0},
{“hour”:“11”,“successCount”:1,“failCount”:0,“readCount”:0,“buttonClickCount”:0,
“sendRate”:100.0,“readRate”:0.0,“clickRate”:0.0,“ctr”:0.0}]}}}
시간대별로 발송 건수는 제대로 나뉘는데 읽음만 0입니다.
- 브랜드메시지도 동일
GET /api/comm/v1/center/statistics/brandmessage?senderKey=f851957d…&startDate=20260820&endDate=20260826
{“common”:{“authCode”:“A000”,“infobankTrId”:“M-260831121841322PRD99922”,“authResult”:“SUCCESS”},
“data”:{“code”:“A000”,“result”:“Success”,“data”:{“statistics”:[
{“successCount”:3,“failCount”:0,“readCount”:0,“buttonClickCount”:0,“listClickCount”:0,
“thumbnailClickCount”:0,“etcClickCount”:0,“sendRate”:100.0,“readRate”:0.0,“clickRate”:0.0,“ctr”:0.0}]}}}
저희가 먼저 확인해 본 것들
집계 지연은 원인이 아닌 것 같습니다. 안내받기로는 D+1 1차 → D+2 2차 → D+3부터 고정이라고 했는데, D+3이 한참 지난 7월 발송분도 readCount가 0입니다.
GET …/statistics/alimtalk?senderKey=f851957d…&startDate=20260701&endDate=20260707
→ {“infobankTrId”:“M-260831121841455PRD05587”, …
“statistics”:[{“successCount”:10,“failCount”:0,“readCount”:0, … “sendRate”:100.0,“readRate”:0.0}]}
하루만 조회해도 동일합니다.
GET …/statistics/alimtalk?senderKey=f851957d…&startDate=20260824&endDate=20260824
→ {“infobankTrId”:“M-260831121841417PRD05586”, …
“statistics”:[{“successCount”:6,“failCount”:0,“readCount”:0, … “sendRate”:100.0,“readRate”:0.0}]}
계정 기본 발신프로필로 조회하면 빈 배열이 옵니다. (발송이 일어난 발신프로필이 아니라서로 이해했습니다)
GET …/statistics/alimtalk/template?senderKey=(계정 기본키)&startDate=20260801&endDate=20260807
→ {“infobankTrId”:“M-260831161921218PRD96850”, … “statistics”:}
참고로 /api/comm/v1/message/statistics는 값이 정상적으로 옵니다.
→ {“infobankTrId”:“M-260831122351733PRD11270”, …
“statistics”:[{“statDate”:“20260820”,“serviceType”:“ALIMTALK”,“recvTotalCnt”:1,“recvSuccCnt”:1, …},
{“statDate”:“20260824”,“serviceType”:“ALIMTALK”,“recvTotalCnt”:6,“recvSuccCnt”:6, …}]}
다만 여기엔 읽음 항목이 없고 계정 전체 기준이라, 저희가 필요한 읽음 통계는 못 얻습니다.
[질문]
- readCount·readRate·buttonClickCount가 계속 0인 원인이 무엇인가요? 카카오 채널 인사이트를 별도로 신청·설정해야 값이 쌓이기 시작하는 건가요?
- 알림톡도 읽음(오픈) 집계가 제공되나요? 아니면 브랜드메시지(친구톡) 전용인가요?
- 발송할 때(POST /api/comm/v1/send/omni) 읽음 집계를 켜기 위해 넣어야 하는 파라미터가 따로 있나요? 저희는 지금 destinations + messageFlow + ref만 보내고 있습니다.
- 읽음 집계가 시작되는 조건이 있나요? (예: 채널 친구 수, 일정 발송량 이상, 특정 메시지 유형 등)
- buttonClickCount는 알림톡의 웹링크 버튼 클릭도 잡히나요?
- 읽음 수치가 D+2까지 갱신된다면, 일별로 쌓아 보관하려면 startDate=endDate=하루로 부른 값을 D+2까지 여러 번 다시 긁어서 덮어써야 하는 게 맞나요? 권장 방식이 있으면 알려주세요.
- /api/comm/v1/center/statistics/* 는 조회 기간이 7일을 넘으면 거부됩니다. 문서에 안 적혀 있어 부딪혀보고 알았습니다.
[7일 20260820~20260826] A000 Success
[8일 20260820~20260827] A213 The query period cannot exceed 7 days.
[31일 20260801~20260831] A213 The query period cannot exceed 7 days.
{“common”:{“authCode”:“A000”,“infobankTrId”:“M-260831121714125PRD04113”,“authResult”:“SUCCESS”},
“data”:{“code”:“A213”,“result”:“The query period cannot exceed 7 days.”}}
(HTTP 400)
감사합니다.
