> For the complete documentation index, see [llms.txt](https://workspace-help.nhn-commerce.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://workspace-help.nhn-commerce.com/aurora-guide/api-1/mypage-post/inquiry.md).

# 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 문의를 삭제 합니다.