> 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/undefined-1/1-1.md).

# 1:1 문의

고객이 편리하게 상담을 할 수 있도록 1대1 문의 기능을 제공합니다. 고객은 고객센터를 통해 문의를 등록할 수 있으며, 최근 주문이나 상품 검색을 통해 관련 상품을 선택할 수 있습니다. 등록된 문의는 '접수완료' 상태일 때만 수정 또는 삭제가 가능하며, 관리자(상담원)은 BO 통합상담관리에서 해당 문의를 처리하거나 답변할 수 있습니다.

***

## 주요 기능

* **1대1 문의 등록**
  * 고객은 고객센터를 통해 1대1 문의를 등록할 수 있습니다.
  * 최근 주문이나 상품 검색을 통해 관련 상품을 선택할 수 있습니다.
* **문의 검색 및 상세 확인**
  * 특정 기간 내에 고객이 등록한 문의 글을 검색하고 상세 내용을 확인할 수 있습니다.
* **문의 글 수정 및 삭제**
  * 문의 글이 '접수완료' 상태인 경우 고객은 문의 글을 수정하거나 삭제할 수 있습니다.
* **상담원 답변 기능**
  * 관리자(상담원)은 BO 통합상담관리에서 고객이 등록한 문의에 대해 답변을 작성할 수 있습니다.
  * 답변이 완료된 경우 상태는 '답변완료'로 변경되어 수정 또는 삭제가 불가능합니다.

## 프로세스 정의

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FQoiQup3gmvvF3vosNKXh%2F%E1%84%80%E1%85%A9%E1%84%80%E1%85%A2%E1%86%A8%E1%84%89%E1%85%A6%E1%86%AB%E1%84%90%E1%85%A5.png?alt=media&amp;token=e3fbe9d7-703e-4cf3-b248-f50ffa5e2ef9" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 1:1문의 목록 조회

고객센터에서 1대1문의 클릭 시 기간에 따른 1대1 문의 목록을 출력합니다.
{% endstep %}

{% step %}

### 1:1 문의 유형 조회

1대1 문의를 할 수 있는 유형 목록을 조회합니다.
{% endstep %}

{% step %}

### 상품목록 결과조회

1대1 문의 등록 시 문의를 원하는 상품을 선택할 수 있습니다. 원하는 상품을 검색하여 조회합니다.
{% endstep %}

{% step %}

### &#x20;1:1문의 등록하기

작성을 완료한 1대1 문의를 등록합니다.\
작성된 문의는 BO 고객서비스 통합상담관리에서 조회됩니다.
{% endstep %}

{% step %}

### &#x20;1:1문의 상세조회

1대1 문의 목록에서 원하는 1대1 문의 클릭시 해당 문의의 상세 내용을 조회합니다.
{% endstep %}

{% step %}

### &#x20;1:1 문의 수정/삭제

답변이 완료되지 않은 상태이면 문의 내용을 수정하거나 삭제할 수 있습니다.
{% endstep %}

{% step %}

### &#x20;1:1 문의 답변 등록

통합상담관리에서 상담원 또는 관리자가 답변을 등록할 수 있습니다. 답변이 완료되면 해당 문의 상세에 답변 내용이 보여집니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="130.3333740234375">API</th><th>설명</th><th>Server</th><th>메소드</th><th>비</th></tr></thead><tbody><tr><td>1:1문의 목록 조회</td><td>고객이 등록했던 1:1 문의 목록을 조회합니다.<br>조회 기간에 따라 목록을 조회할 수 있습니다.</td><td>Order</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=1%EB%8C%801%EB%AC%B8%EC%9D%98&#x26;path=getQuestion">🔗API 확인하기></a></td></tr><tr><td>1:1문의 문의유형 조회</td><td>1:1문의 등록 시 문의할 수 있는 문의 유형(분류)을 조회합니다.<br>예) 이벤트 ,주문상품</td><td>Order</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=1%EB%8C%801%EB%AC%B8%EC%9D%98&#x26;path=getQuestionInit">🔗API 확인하기></a></td></tr><tr><td>1:1문의 상세내용 조회</td><td>선택한 문의의 상세내용을 조회합니다.</td><td>Order</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=1%EB%8C%801%EB%AC%B8%EC%9D%98&#x26;path=getQuestionDtl">🔗API 확인하기></a></td></tr><tr><td>1:1문의 등록<br>대상 상품 조회</td><td>작성할 문의에 관련된 고객님의 주문 상품 리스트 또는 검색을 통해 상품을 조회할 수 있습니다.</td><td>Order</td><td>POST</td><td><p><a href="http://api.x2bee.com/content?msa=order&#x26;depth=1%EB%8C%801%EB%AC%B8%EC%9D%98&#x26;path=getGoodsList">🔗API 확인하기></a></p><p>1:1문의 나의 주문 상품 조회 호출<br>/v1/customer/getOrderClaimGoodsList</p></td></tr><tr><td>1:1문의 등록</td><td>문의분류, 제목, 내용, 상품검색, 사진첨부를 통하여 작성한 1:1문의를 등록합니다.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=1%EB%8C%801%EB%AC%B8%EC%9D%98&#x26;path=questionSave">🔗API 확인하기></a></td></tr><tr><td>1:1문의 수정</td><td>1:1 문의 상태 값이 ‘접수완료‘인 경우에는 작성한 글을 수정 가능합니다.</td><td>Order</td><td>PUT</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=1%EB%8C%801%EB%AC%B8%EC%9D%98&#x26;path=questionMod">🔗API 확인하기></a></td></tr><tr><td>1:1문의 삭제</td><td>1:1 문의 상태 값이 ‘접수완료‘인 경우에는 작성한 글을 삭제 가능합니다.</td><td>Order</td><td>DELETE</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=1%EB%8C%801%EB%AC%B8%EC%9D%98&#x26;path=questionDel">🔗API 확인하기></a></td></tr></tbody></table>