# \[웹훅 추가] 앱 설치 및 삭제

### 업데이트 일자: 2022.10.28

```
[웹훅 추가] 새롭게 추가개발된 웹훅(Webhook)에 대해 안내드리는 콘텐츠입니다.
```

<br>

## **앱 설치/삭제 웹훅이란?**

shopby 솔루션 어드민에 1) 앱이 설치되거나 2) 설치된 앱이 삭제됐을 때

앱이 설치되거나, 설치된 앱이 삭제된 경우 웹훅을 통해 등록된 고객사의 외부 URI로 알려주는 REST API call입니다.

<figure><img src="https://rlyfaazj0.toastcdn.net/20221027/171416.20169000/%EC%9B%B9%ED%9B%85.png" alt=""><figcaption></figcaption></figure>

* <mark style="color:blue;">**지원 가능한 method**</mark>: POST / PUT
* <mark style="color:blue;">**웹훅 발행시점**</mark>
  1. 앱 설치(ACTIVE)\
     → 앱이 설치됐을 때 웹훅 전달
  2. 앱 삭제(DELETED)\
     → 설치된 앱이 삭제됐을 때 웹훅 전달
* <mark style="color:blue;">**Request Body**</mark>

  ```
  {
    mallNo: 쇼핑몰 번호
    curretStatus: ACTIVE(설치)/DELETED(삭제)
    appNo: 앱일련번호
    appInstalledNo: 앱설치번호
  }
  ```

***

## **웹훅 사용설정 방법**

1. <mark style="color:blue;">**웹훅 설정 경로**</mark>
   * 워크스페이스> 셀러어드민 내  앱(APP) 등록/수정 시 설정할 수 있습니다.
2. <mark style="color:blue;">**웹훅 주의사항**</mark>
   * shopby 서버 또는 웹훅을 받는 서버의 문제로 일정 시간 웹훅이 통신되지 않을 경우 이미 발생했던 이벤트는 다시 전송되지 않습니다.


---

# 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/contents/recommended/undefined-3.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.