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

### 업데이트 일자: 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 서버 또는 웹훅을 받는 서버의 문제로 일정 시간 웹훅이 통신되지 않을 경우 이미 발생했던 이벤트는 다시 전송되지 않습니다.