안녕하세요. 카카오쇼핑 입니다.
카카오쇼핑 고객센터에서 전달하는 긴급알림 메시지를 API를 통해 조회/답변할 수 있도록 긴급알림 API를 신규로 제공합니다.
긴급알림을 API 연동을 통해 확인 및 처리하고자 하는 경우, 아래 신규 API 스펙을 확인해주시기 바랍니다.
긴급알림이란?
긴급알림은 배송 지연, 상품 미도착·누락, 교환/반품 처리 지연, 안전거래센터 공지 등 판매자의 확인이나 조치가 필요한 운영성 이슈 발생 시 전달되는 알림입니다.
| ✓ 대상채널 | 선물하기,톡스토어 |
|---|---|
| ✓ 제공일자 | 2026년 8월 11일 |
| ✓ 신규 제공 API | 긴급알림 목록 조회 / 긴급알림 상세 조회 / 긴급알림 피드백 등록 및 확인 |
주요 제공 기능
-
긴급알림 목록 조회 API
등록일 또는 처리완료일을 기준으로 긴급알림 내역을 조회할 수 있습니다. 처리상태, 장기 미처리 여부, 판매채널, 상품번호, 주문번호, 긴급알림번호 등의 조건을 활용한 조회를 지원합니다.
-
긴급알림 상세 조회 API
특정 긴급알림의 전체 내용 및 연결된 상품/주문정보, 판매자 피드백 내역 등을 확인할 수 있습니다.
-
긴급알림 피드백 등록 및 확인 API
긴급알림 유형에 따라 판매자가 댓글을 등록하거나 확인 처리를 할 수 있습니다.
1. 긴급알림 목록 조회 API
카카오쇼핑 고객센터에서 판매자에게 전달한 긴급알림 내역을 조회합니다.
GET /v1/shopping/bizseller/emergency-article
- 등록일 또는 처리완료일 기준 기간 조회
- 처리상태 조회
- UNPROCESSED : 미처리
- PROCESSING : 처리중
- COMPLETED : 처리완료
- CLOSED : 종결
- 장기 미처리 알림 조회
- 채널상품번호 기준 조회
- 주문번호 또는 긴급알림번호 기준 조회
※ 비노출 처리된 긴급알림은 조회 대상에서 제외됩니다.
※ 목록 조회의 긴급알림 본문은 HTML을 제거한 후 약 150byte로 축약하여 제공되며, 전체 내용은 상세 조회 API를 통해 확인할 수 있습니다.
2. 긴급알림 상세 조회 API
특정 긴급알림의 상세 내용을 조회할 수 있습니다.
GET /v1/shopping/bizseller/emergency-article/detail
- 긴급알림 전체 내용
- 긴급알림 처리상태
- 판매자 댓글 등록 가능 여부
- 판매자/카카오쇼핑 간 피드백 내역
- 긴급알림과 연결된 상품 및 주문정보
- 본문 및 댓글 첨부파일 정보
- 개인정보 영역 정보
※ 긴급알림이 처리완료 또는 종결된 이후에는 개인정보 보호를 위해 개인정보 영역이 마스킹되어 제공됩니다.
3. 긴급알림 피드백 등록 및 확인 API
긴급알림 상세 조회 시 제공되는 commentRegistrableYn 값에 따라 댓글 등록 또는 확인 처리가 가능합니다.
POST /v1/shopping/bizseller/emergency-article/feedback
| 구분 | 처리 방법 |
|---|---|
| commentRegistrableYn = Y |
actionType = COMMENT 판매자 댓글 등록이 필요하며, 처리 후 상태는 PROCESSING으로 변경됩니다. 필요한 경우 첨부파일을 함께 등록할 수 있습니다. |
| commentRegistrableYn = N |
actionType = CONFIRM 별도의 댓글 없이 확인 처리하며, 처리 후 상태는 COMPLETED로 변경됩니다. |
※ 이미 CLOSED(종결) 상태인 긴급알림은 추가 처리할 수 없습니다.
※ 동일 긴급알림에 동일한 actionType으로 반복 요청할 경우 호출할 때마다 처리 이력이 추가되므로, 중복 호출이 발생하지 않도록 유의해주시기 바랍니다.
[참고] 긴급알림 API 데이터 타입
| EmergencyArticleSummary | 긴급알림 목록 조회 데이터 타입 |
| EmergencyArticle | 긴급알림 상세 조회 데이터 타입 |
| EmergencyArticleStatus | 긴급알림 처리상태 데이터 타입 |
| EmergencyArticleActionType | 긴급알림 처리 유형 데이터 타입 |
| EmergencyArticleComment | 긴급알림 피드백 댓글 데이터 타입 |
| EmergencyArticleCommentCreatorType | 긴급알림 댓글 등록자 유형 데이터 타입 |
| EmergencyArticleAttachedFile / EmergencyArticleCommentAttachedFile | 본문/댓글 첨부파일 데이터 타입 |
| EmergencyArticleProductOrder | 긴급알림에 연결된 상품/주문 데이터 타입 |
참고사항
- 긴급알림 처리상태(UNPROCESSED, PROCESSING, COMPLETED, CLOSED)를 기준으로 처리 로직을 구성해주세요.
- 긴급알림의 상세 내용을 확인한 후 commentRegistrableYn 값에 따라 댓글 등록 또는 확인 처리를 진행해주세요.
- 피드백 API 중복 호출 시 동일한 처리 이력이 반복 생성될 수 있으므로 중복 호출 방지 로직을 적용해주세요.
자세한 요청/응답 규격 및 데이터 타입은 긴급알림 API 가이드를 참고해주시기 바랍니다.
감사합니다.