> 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 %}

<p align="center"><strong>PC</strong></p>

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FBv2hBHERnccgRhXnflKC%2Fimage-20240416-044420.png?alt=media&amp;token=c3d0b241-0112-4255-afc6-182cc1d527e1" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<p align="center"><strong>Mobile</strong></p>

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FEqZU1gJuhbOAGkdLVuwl%2Fimage-20240416-044430.png?alt=media&amp;token=a9c752f8-f9a2-4f35-9dc4-b1e1b18845ec" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

## 고객센터 공지 팝업 <a href="#plus" id="plus"></a>

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266109731/FO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0-%EA%B3%A0%EA%B0%9D%EC%84%BC%ED%84%B0.drawio.png" alt=""></p>

### 1. 공지 팝업 <a href="#id-1" id="id-1"></a>

고객센터 접속 시 고객에게 알리는 공지 팝업창을 띄울 수 있습니다.

* **사이트 팝업목록 조회 (**[🔗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 
```

***

## 고객센터 페이지 <a href="#plus" id="plus"></a>

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266109731/FO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0-%EA%B3%A0%EA%B0%9D%EC%84%BC%ED%84%B0%20%ED%8E%98%EC%9D%B4%EC%A7%80.drawio.png" alt=""></p>

### 1. 공지사항 목록 <a href="#id-1" id="id-1"></a>

고객센터 메인 화면에서 고객 공지사항 목록 조회 할 수 있습니다.

공지사항 전체보기를 통해 등록된 전체 공지사항 목록을 조회(상단고정게시물 우선 표시)합니다.

* **공지사항 목록 조회 (**[🔗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. 공지사항 상세보기, 공지사항 조회수 증가 <a href="#id-2" id="id-2"></a>

고객센터 페이지에서 공지사항 목록을 선택하면 공지사항 상세 내용을 조회할 수 있습니다.

* **공지사항 상세 조회 (**[🔗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 
```

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266109731/FO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0-%EA%B3%A0%EA%B0%9D%EC%84%BC%ED%84%B0%20FAQ.drawio.png" alt=""></p>

### 3. FAQ 목록 조회 <a href="#id-3.-faq" id="id-3.-faq"></a>

등록한 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 조회수 증가 <a href="#id-4.-faq" id="id-4.-faq"></a>

고객이 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 문의하기 페이지 <a href="#plus-1-1" id="plus-1-1"></a>

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266109731/FO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0-%EA%B3%A0%EA%B0%9D%EC%84%BC%ED%84%B0%20%EB%AC%B8%EC%9D%98%ED%95%98%EA%B8%B0.drawio.png" alt=""></p>

### 1. 문의 내역 조회 <a href="#id-1" id="id-1"></a>

로그인한 회원을 대상으로 1:1 문의 내역에 대한 목록을 조회할 수 있습니다.

&#x20;

* **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. 문의 내용 상세보기 <a href="#id-2" id="id-2"></a>

고객이 작성한 문의 내용을 상세하게 볼 수 있습니다.&#x20;

**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 
```

![](https://tech.x2bee.com/download/attachments/266109731/FO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0-%EB%AC%B8%EC%9D%98%ED%95%98%EA%B8%B0%20%EC%9E%91%EC%84%B1.drawio.png)

### 3. 문의 유형 선택하기 <a href="#id-3" id="id-3"></a>

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. 상품 검색하기 <a href="#id-4" id="id-4"></a>

1:1 문의 내용 작성 시 문의를 위한 상품을 선택하기 위해 상품 검색기능을 제공하고 있습니다.

\[상품검색] 버튼을 클릭하면 상품 선택하기 팝업창이 나타납니다.

&#x20;

**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 
```