> 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="/files/V9IBtoNHd2BuE1sEt5HT" 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>


---

# 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/undefined-1/1-1.md?ask=<question>
```

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.