> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/store-front-api/undefined-1/undefined-5.md).
# 고객센터
이커머스 웹사이트나 애플리케이션에서 고객 지원 및 서비스 관련 기능을 제공하는 데 사용됩니다.
이 API는 사용자의 문의, 요청, 불만 사항 등을 관리하고 고객 지원팀과의 원활한 커뮤니케이션을 지원합니다.
***
{% columns %}
{% column %}
### 1. 공지 팝업
고객센터 접속 시 고객에게 알리는 공지 팝업창을 띄울 수 있습니다.
* **사이트 팝업목록 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=display\&depth=%EC%82%AC%EC%9D%B4%ED%8A%B8%20%EC%A0%84%EC%8B%9C%EB%AA%B0/getSitePopupList))\
해당 사이트의 팝업 정보 목록을 조회할 수 있습니다.
```
GET /v1/site/popupList
```
***
## 고객센터 페이지
### 1. 공지사항 목록
고객센터 메인 화면에서 고객 공지사항 목록 조회 할 수 있습니다.
공지사항 전체보기를 통해 등록된 전체 공지사항 목록을 조회(상단고정게시물 우선 표시)합니다.
* **공지사항 목록 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EA%B3%B5%EC%A7%80%EC%82%AC%ED%95%AD%20FAQ/getNotice))\
고객센터 메뉴에서 요청한 개수만큼 공지사항 목록을 조회합니다.
전체보기 공지사항 전체 목록을 조회합니다.
```
GET /v1/customerservice/notice
```
### 2. 공지사항 상세보기, 공지사항 조회수 증가
고객센터 페이지에서 공지사항 목록을 선택하면 공지사항 상세 내용을 조회할 수 있습니다.
* **공지사항 상세 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EA%B3%B5%EC%A7%80%EC%82%AC%ED%95%AD%20FAQ/getNoticeDtl))\
고객센터 메인 화면에서 선택한 공지사항 상세 정보를 조회합니다.
고객이 공지사항을 조회할 경우 해당 조회수를 업데이트하여 저장할 수 있습니다.
```
GET /v1/customerservice/noticeDtl
```
* **공지사항 조회수 증가 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EA%B3%B5%EC%A7%80%EC%82%AC%ED%95%AD%20FAQ/questionReadCntSave))\
공지사항 상세내용과 공지사항 조회수 증가를 확인합니다.
```
PUT /v1/customerservice/questionReadCntSave
```
### 3. FAQ 목록 조회
등록한 FAQ의 목록을 조회 할 수 있습니다.
전체 보기를 통해 FAQ 전체 목록과 분류 항목에 따른 목록을 조회 할 수 있습니다.
* **FAQ(자주묻는질문) 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EA%B3%B5%EC%A7%80%EC%82%AC%ED%95%AD%20FAQ/getFaqInit))\
고객센터 메인에서 요청한 개수 만큼 FAQ 목록을 조회하며, 다국어로 작성 된 FAQ를 구분하여 호출할 수 있습니다.)
```
GET /v1/customerservice/faqInit
```
### 4. FAQ 조회수 증가
고객이 FAQ를 조회할 경우 해당 조회수를 업데이트하여 저장할 수 있습니다.
* **FAQ(자주묻는질문) 조회수 증가 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EA%B3%B5%EC%A7%80%EC%82%AC%ED%95%AD%20FAQ/questionReadCntSave))\
FAQ 상세내용과 FAQ 조회수 증가를 조회합니다.
```
PUT /v1/customerservice/questionReadCntSave
```
***
## 1:1 문의하기 페이지
### 1. 문의 내역 조회
로그인한 회원을 대상으로 1:1 문의 내역에 대한 목록을 조회할 수 있습니다.
* **1:1 문의 목록 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=1%EB%8C%801%EB%AC%B8%EC%9D%98/getQuestion))\
1:1 문의로 등록 된 목록을 조회합니다.
```
GET /v1/customerservice/question
```
### 2. 문의 내용 상세보기
고객이 작성한 문의 내용을 상세하게 볼 수 있습니다.
**2.1 1:1 문의 내역 조회하기**\
고객이 작성한 문의 내용을 상세하게 볼 수 있습니다.
* **1:1문의 내역 상세조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=1%EB%8C%801%EB%AC%B8%EC%9D%98/getQuestionDtl))\
작성된 1:1 문의 내용을 조회합니다.
```
GET /v1/customerservice/questionDtl
```
\
**2.2 문의 내용 수정하기**
고객이 작성한 문의 내용을 수정 할 수 있습니다.
* **1:1문의 수정(**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=1%EB%8C%801%EB%AC%B8%EC%9D%98/questionMod))\
1:1문의 내용을 수정 처리 합니다.
```
POST /v1/customerservice/questionMod
```
**2.3 문의 내용 삭제하기**
고객이 작성한 문의 내용을 삭제 할 수 있습니다.
* **1:1문의 삭제 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=1%EB%8C%801%EB%AC%B8%EC%9D%98/questionDel))\
1:1문의 내용을 삭제합니다.
```
DEL /v1/customerservice/questionDel
```
### 3. 문의 유형 선택하기
1:1 문의 내용 작성 시 분류한 문의 유형을 대분류와 소분류로 나눠서 선택 할 수 있습니다.
* **1:1 문의 유형 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=1%EB%8C%801%EB%AC%B8%EC%9D%98/getQuestionInit))\
1:1 문의 유형코드를 대분류와 소분류로 기준으로 조회합니다.
```
GET /v1/customerservice/questionInit
```
### 4. 상품 검색하기
1:1 문의 내용 작성 시 문의를 위한 상품을 선택하기 위해 상품 검색기능을 제공하고 있습니다.
\[상품검색] 버튼을 클릭하면 상품 선택하기 팝업창이 나타납니다.
**4.1 나의 주문 상품 조회**
1:1 문의를 위해 구매한 상품정보를 조회하고 선택할 수 있습니다.
* **1:1문의 나의 주문상품조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EA%B3%A0%EA%B0%9D%20%EC%84%BC%ED%84%B0%20%EC%A0%9C%EA%B3%B5/getOrderClaimGoodsList))\
나의 주문 상품을 조회합니다.
```
POST /v1/customer/getOrderClaimGoodsList
```
**4.2 상품 검색**
상품 문의를 위한 상품을 검색하고 선택할 수 있습니다.
* **1:1문의 등록대상 상품 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=1%EB%8C%801%EB%AC%B8%EC%9D%98/getGoodsList))\
1:1 문의를 위한 상품을 검색합니다.
```
POST /v1/customerservice/searchGoods
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://tech.x2bee.com/api-guide/store-front-api/undefined-1/undefined-5.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
