# 1:1 문의

1:1문의는 어드민 아래 경로에서 설정이 가능합니다. 

```
shop by basic/pro : 게시판 > 게시판 관리 > 1:1문의 > 1:1문의 설정(탭)
shop by premium : 운영관리 > 1:1문의 관리 > 1:1문의 설정(탭)
```

1:1 문의는 회원에게만 제공되며, 비회원에게는 제공하지 않습니다. \
게시글은 비밀글로 모두 저장되어 등록자 자신과 운영자(어드민에서 게시글 확인)만 게시글 확인이 가능합니다.

<figure><img src="/files/ZDINKwOtVTcfF3coT1M8" alt=""><figcaption></figcaption></figure>

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

> [GET /inquiries](https://docs.shopby.co.kr/?url.primaryName=manage/#/Inquiry/search-inquiries)
>
> ▶ 일대일 문의 내역 조회하기\
> 일대일 문의글 목록을 전체 검색합니다.

조회 시 해당 회원의 1:1 문의만 조회해야 하므로 요청 시 accessToken 값에 해당 회원의 accessToken 값을 추가하여 조회 하셔야 합니다.\
기본 스킨에서는 게시글 번호, 문의유형, 문의 제목, 문의일, 답변 상태 값을 노출하여 제공합니다.

> [GET /inquiries/{inquiriesNo}](https://docs.shopby.co.kr/?url.primaryName=manage/#/Inquiry/get-inquiry)
>
> ▶ 일대일 문의 상세 조회하기\
> 문의 번호 기준으로 일대일 문의 상세 내용을 조회합니다.

답변이 완료 되지 않은 문의 글에 대해서만 수정 및 삭제가 가능합니다.\
수정/삭제 API는 하단 내용에서 확인하실 수 있습니다.

<mark style="color:purple;">**\[답변대기 1:1문의]**</mark>

<figure><img src="/files/Ao93mkRvEWwbAUVPOJvL" alt=""><figcaption></figcaption></figure>

<mark style="color:purple;">**\[답변완료 1:1문의]**</mark>

<figure><img src="/files/L2AopEFFdaGQgubtRchF" alt=""><figcaption></figcaption></figure>

#### ◼︎ 1:1 문의 등록

<figure><img src="/files/jgcdWHJeQLK25kwMbf2H" alt=""><figcaption></figcaption></figure>

1:1 문의 목록에서 제공하는 \[1:1문의 등록] 버튼을 통해 게시글 등록이 가능합니다.\
\[1:1 문의 등록] 버튼 클릭 시 1:1 문의 내용을 입력할 수 있는 페이지를 제작하여 회원에게 제공합니다.\
기본 스킨에서는 아래의 항목을 제공합니다.

* 문의유형 : 문의유형은 어드민에서 등록한 문의 유형을 select-box로 제공합니다.
* 제목 : 제목은 최대 50자 까지 입력 가능합니다.
* 내용 : 내용은 최대 1000자 까지 입력 가능합니다.
* 첨부파일 : 첨부파일은 최대 10개 등록 가능하며, 1개 파일 당 용량은 5MB로 제한됩니다.
* 답변등록 알림 (SMS/이메일 수신) : 어드민의 자동 SMS설정, 자동 메일 설정 여부에 따라 답글 등록 시 1:1문의 등록자에게 답변 완료에 대해 안내 됩니다.&#x20;

> [POST /inquiries](https://docs.shopby.co.kr/?url.primaryName=manage/#/Inquiry/add-inquiry)
>
> ▶ 1:1 문의 등록하기\
> 1:1 문의를 등록합니다.

1:1 문의 등록 페이지 내 내용을 입력한 후에는 1:1 문의 등록 페이지에서 문의 등록을 위해 저장 버튼을 클릭합니다.\
저장 버튼 클릭 시 1:1 문의 등록 API를 호출하여 게시글을 등록합니다.<br>

#### ◼︎ 1:1문의 수정

> [PUT /inquiries/{inquiryNo}](https://docs.shopby.co.kr/?url.primaryName=manage/#/Inquiry/modify-inquiry)
>
> ▶ 1:1 문의 변경하기\
> 특정 1:1문의를 수정합니다.

1:1 문의 수정은 1:1문의 상세 페이지에서 기능 제공하며, 1:1 문의 수정하기를 위해서는 아래의 프로세스로 진행됩니다.\
inquiryStatus (답변상태) 값이 답변완료인 경우 수정 버튼을 미노출하여 답변완료인 경우 수정 기능을 제공하지 않습니다.

* 1:1 문의 상세 조회하기 API를 통해 수정하려는 1:1문의 내용을 조회 한 후 1:1문의 등록 팝업 내 등록한 문의 내용을 출력
* 출력 된 내용을 기반으로 쇼핑몰 회원이 1:1문의를 수정하여 등록
* 1:1문의 수정하기 API를 통해 수정 요청

#### ◼︎ 1:1문의 삭제 <a href="#undefined" id="undefined"></a>

> [DELETE /inquiries/{inquiryNo}](https://docs.shopby.co.kr/?url.primaryName=manage/#/Inquiry/remove-inquiry)
>
> ▶ 1:1 문의 삭제하기\
> 특정 1:1문의를 삭제합니다.

1:1 문의 삭제는 1:1문의 상세 페이지에서 기능 제공하며, 답변이 완료 되지 않은 문의건에 대해서만 삭제 가능합니다.\
1:1 문의 상세 조회 시 <mark style="background-color:yellow;">inquiryStatus (답변상태)</mark> 값이 답변완료인 경우 삭제 버튼을 미노출 하여 답변완료인 경우 삭제 기능을 제공하지 않습니다.\
답변이 완료되지 않은 1:1 문의의 경우 삭제 버튼 클릭 시 1:1문의 삭제하기 API를 호출하여 특정 1:1 문의를 삭제 합니다.


---

# Agent Instructions: 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://workspace-help.nhn-commerce.com/aurora-guide/api-1/mypage-post/inquiry.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.