# Shopify 주문 알림: 새 주문마다 휴대폰 푸시 받기

> Shopify 주문이 들어올 때마다 아이폰이나 안드로이드에 푸시 알림을 받으세요. 주문 번호, 결제 금액, 고객명, 첫 상품을 함께 보여줍니다. Shopify 관리자에 웹훅 하나만 추가하면 되고, 스토어에 설치할 앱도 없습니다. 취소, 환불, 대량 주문, 재고 부족 알림도 지원합니다.

*21.10.2026*

<!-- source: https://pocketalert.app/ko/blog/shopify-order-notifications -->

새 주문은 모든 스토어 운영자가 바로 알고 싶어 하는 이벤트입니다. 처음에는 하루에 스무 번씩 관리자 화면을 확인하게 되죠. 시간이 지나면 포장 담당자, 고객 문의를 맡은 파트너, 일부 상품을 대신 발송해 주는 공급업체가 생기고, 그들은 고객이 배송을 묻기 전에 판매 소식을 먼저 알고 싶어 합니다.

Shopify는 이미 주문 소식을 받을 수 있는 방법을 두 가지 제공합니다. 무언가를 추가하기 전에 먼저 알아두면 좋습니다. 이 가이드에서는 두 방법을 살펴본 뒤, Shopify 관리자에 웹훅 하나를 추가해 주문마다 Pocket Alert 푸시를 받도록 설정합니다. 5분 정도면 끝나고, 스토어에 설치하는 것은 없습니다.

## Shopify 기본 기능으로 받을 수 있는 알림

**Shopify 앱.** 아이폰과 안드로이드에서 Shopify 앱은 새 주문 푸시를 보내줄 수 있습니다. 앱에서 **설정 → 알림**(안드로이드에서는 **스토어 알림**)을 열고 주문 푸시를 켜세요. 아이폰에서는 열린 주문 수를 배지로도 보여줍니다. 쓸 만하지만 한계가 있습니다. 이 푸시를 받으려는 사람은 모두 주문에 접근 권한이 있는 직원 계정으로 Shopify 앱에 로그인해야 합니다.

**직원 알림 이메일.** **설정 → 알림 → 직원 알림**에서 Shopify는 기본적으로 스토어 소유자에게 "New order" 이메일을 보냅니다. 직원이나 임의의 이메일 주소를 수신자로 추가할 수도 있습니다. 무료이고 안정적이지만 이메일이라서 뉴스레터나 영수증 사이에 묻히고, 소리 알림도 울리지 않습니다.

이 두 가지로 충분하다면 여기서 멈추셔도 됩니다. 다음과 같은 것이 필요할 때 Pocket Alert 푸시를 추가할 가치가 있습니다.

- **Shopify 좌석이 없는 휴대폰.** Pocket Alert 계정에 로그인한 모든 휴대폰(iOS 또는 안드로이드)으로 푸시가 전달됩니다. 포장 담당자나 파트너에게 스토어의 직원 계정을 만들어 줄 필요가 없습니다.
- **알림 중요도 설정.** 일반 주문은 조용히 도착하게 하고, 대량 주문은 집중 모드를 뚫고 울리게 할 수 있습니다. 중요도마다 안드로이드 알림 채널이 따로 있어서 하나만 음소거하고 나머지는 켜 둘 수 있습니다.
- **검색 가능한 기록.** 모든 푸시는 앱에 남고, 콘솔에는 Shopify가 보낸 요청 기록이 모두 저장됩니다. 주문이 누락된 것 같을 때 확인하기 좋습니다.
- **모든 알림을 한 앱에서.** 주문 알림이 Stripe 결제, 가동 시간 점검, 서버 경고와 같은 피드에 함께 쌓입니다.
- **버튼.** 푸시에 **Open order** 버튼을 넣어 관리자의 주문 화면으로 바로 이동할 수 있습니다.

## 준비할 것

- Shopify 스토어와 **설정 → 알림** 접근 권한.
- Pocket Alert 계정과 휴대폰에 설치한 [앱](/get-app). 이 가이드는 무료 플랜으로도 가능합니다. 하루 50개 메시지, 기기 1대, 웹훅 1개를 쓸 수 있습니다. 버튼, 추가 기기, 추가 웹훅은 [유료 플랜](/pricing)에서 쓸 수 있습니다.

## 1단계: Pocket Alert 웹훅 만들기

콘솔에서 [웹훅](/webhooks)을 열고 웹훅을 만드세요.

- **이름:** `Shopify orders`. Pocket Alert는 이 이름을 푸시 제목에 씁니다. 제목은 "Webhook Shopify orders"로 표시됩니다.
- **기본 중요도:** 우선 `Default`로 두세요.
- **메시지:** 아래 템플릿.

```text
%name% · %total_price% %currency% · %customer.first_name%
%line_items.0.title% · %line_items.#% products
```

각 `%...%`는 Shopify가 보내는 JSON의 경로입니다. 다음은 `orders/create` 페이로드의 실제 필드입니다.

- `name`은 고객에게 보이는 주문 이름으로, `#1042`처럼 표시됩니다. (`order_number`는 `#`이 없는 같은 번호입니다.)
- `total_price`와 `currency`는 주문 총액과 스토어 통화입니다.
- `customer.first_name`은 고객의 이름입니다. 일부 POS 판매처럼 고객 정보가 없는 주문에서는 비어 있습니다.
- `line_items.0.title`은 첫 번째 상품이고, `line_items.#`은 주문의 항목 수입니다. 총 수량이 아니라 서로 다른 상품의 개수입니다.

웹훅을 저장하고 수신 URL을 복사하세요. `https://p4a.me/wh/abc123...` 형식입니다.

## 2단계: Shopify에 웹훅 추가하기

1. Shopify 관리자에서 **설정 → 알림**으로 이동하세요.
2. **웹훅**을 클릭한 뒤 **웹훅 만들기**를 클릭하세요.
3. **이벤트:** `Order creation`. 이벤트는 나중에 바꿀 수 없습니다.
4. **형식:** `JSON`. Pocket Alert는 JSON만 받습니다. XML로 보내면 푸시가 오지 않습니다.
5. **URL:** `https://p4a.me/wh/...` 형식의 수신 URL.
6. **웹훅 API 버전:** 목록에서 최신 안정 버전을 고르세요. 여기서 쓰는 필드는 최근 버전에 모두 있습니다.
7. **저장**을 클릭하세요.

컴퓨터가 없을 때는 Shopify 모바일 앱에서도 같은 화면을 볼 수 있습니다. **설정 → 알림 → 웹훅**(스토어 설정 섹션)에 있습니다.

이제 새 웹훅의 **...** 메뉴를 클릭하고 **테스트 보내기**를 선택하세요. Shopify가 샘플 주문을 보내고, 1초 안에 휴대폰에 다음과 같은 알림이 뜹니다.

```text
Webhook Shopify orders
#9999 · 404.95 USD · John
Aviator sunglasses · 5 products
```

이것은 Shopify의 샘플 데이터입니다. 다음 실제 주문도 같은 방식으로 도착하며, 값은 실제 주문 정보로 채워집니다.

## 3단계: 더 좋게 다듬기

### 중요도 정하기

Shopify 페이로드에는 `level` 필드가 없어서 모든 푸시는 웹훅의 기본 중요도를 따릅니다. 주문량에 따라 정하세요.

- **하루 몇 건:** `High`. 아이폰에서는 시간 민감 알림으로 처리되어 집중 모드를 뚫고 옵니다.
- **하루 수십 건:** `Low`. 앱에 조용히 쌓이고, 원할 때 확인하면 됩니다. 다른 알림은 계속 크게 울립니다.

콘솔에서 웹훅을 편집하면 언제든지 바꿀 수 있습니다. 각 중요도가 iOS와 안드로이드에서 어떻게 작동하는지는 [중요도 수준](https://info.pocketalert.app/features/priority-levels.html) 문서를 참고하세요.

### Open order 버튼 추가하기

Shopify 관리자의 주문 URL은 `https://admin.shopify.com/store/<store>/orders/<id>` 형식입니다. 여기서 `<store>`는 `.myshopify.com` 앞부분이고, `<id>`는 웹훅 페이로드에 들어 있는 주문의 숫자 `id`입니다. 버튼을 만들기에는 이것으로 충분합니다.

콘솔에는 아직 버튼 입력란이 없으므로 API 호출 한 번으로 설정합니다. [API 키](/account/apikeys)가 필요합니다. 먼저 웹훅의 `tid`를 찾으세요.

```bash
curl -s https://api.pocketalert.app/v1/webhooks -H 'Token: YOUR_API_KEY' \
  | jq -r '.[] | "\(.tid)  \(.name)"'
```

그다음 `your-store`를 스토어 핸들로 바꾸어 버튼을 추가하세요.

```bash
curl -X PUT https://api.pocketalert.app/v1/webhooks/WEBHOOK_TID \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"actions": "[{\"type\":\"view\",\"label\":\"Open order\",\"value\":\"https://admin.shopify.com/store/your-store/orders/%id%\"}]"}'
```

`actions`는 JSON 문자열이라서 안쪽 따옴표를 이스케이프했습니다. `%id%` 자리표시자는 주문마다 채워집니다. 안드로이드에서는 "Open order"라고 표시되고, iOS에서는 이 유형의 버튼에 대해 표준 **Open** 레이블이 나옵니다. 버튼은 유료 기능입니다. 무료 플랜에서도 푸시는 도착하지만 버튼은 나오지 않습니다.

### 취소와 환불

Shopify에는 이 경우를 위한 별도 이벤트가 있습니다. 이벤트마다 Pocket Alert 웹훅을 하나씩 만드세요(무료 플랜은 웹훅 1개, 스타터 플랜은 5개까지 가능합니다). 그다음 해당 이벤트를 사용하는 Shopify 웹훅을 추가하세요.

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th>Shopify 이벤트</th><th>Pocket Alert 이름</th><th>템플릿</th></tr></thead>
<tbody>
<tr><th>Order cancellation</th><td>Shopify cancelled</td><td><code>%name% cancelled · %cancel_reason% · %total_price% %currency%</code></td></tr>
<tr><th>Refund create</th><td>Shopify refund</td><td><code>Refund %transactions.0.amount% on order %order_id% · %note%</code></td></tr>
</tbody>
</table>
</div>

환불 페이로드에는 주문 이름이 없고 숫자 `order_id`만 들어 있습니다. 그래서 `%order_id%` 대신 `%id%`를 넣은 같은 Open order 버튼이 어느 주문인지 확인하는 가장 빠른 방법입니다. 환불에는 거래가 여러 건 있을 수 있는데, 템플릿에는 첫 번째 거래만 표시됩니다. 환불 웹훅은 판매 알림과 구분되도록 `High`로 설정하세요.

## Shopify Flow로 대량 주문과 재고 부족 알림 받기

Pocket Alert 템플릿은 필드를 보여줄 수는 있지만 비교는 할 수 없습니다. 그래서 주문 500건짜리가 20건짜리보다 더 크게 울려야 한다고 판단하지 못합니다. Shopify Flow는 이것이 가능합니다. Flow는 무료 Shopify 앱이며, **HTTP 요청 보내기** 작업은 Grow, Advanced, Plus 플랜에서 쓸 수 있습니다. Basic 플랜에서도 Flow는 쓸 수 있지만 이 작업은 없으므로 이 섹션은 동작하지 않습니다.

Flow는 Pocket Alert API를 직접 호출할 수 있어서 제목, 중요도, 버튼을 원하는 대로 설정할 수 있습니다. 먼저 **Flow → 설정**에서 핸들이 `pocketalert`이고 값이 API 키인 비밀 값을 추가하세요.

### 대량 주문에 크게 울리는 푸시

1. 새 워크플로, 트리거는 **주문 생성됨**.
2. 조건: `order.totalPriceSet.shopMoney.amount`가 `500` 이상.
3. 작업 **HTTP 요청 보내기**:
   - **메서드:** `POST`
   - **URL:** `https://api.pocketalert.app/v1/messages`
   - **헤더:** `Token` = `{{secrets.pocketalert}}`, `Content-Type` = `application/json`
   - **본문:**

```liquid
{
  "title": "Big order {{order.name}}",
  "message": "{{order.totalPriceSet.shopMoney.amount}} {{order.totalPriceSet.shopMoney.currencyCode}} · {{order.customer.firstName}}",
  "level": "high",
  "actions": [
    {"type": "view", "label": "Open order",
     "value": "https://admin.shopify.com/store/your-store/orders/{{order.legacyResourceId}}"}
  ]
}
```

Flow 변수는 GraphQL Admin API 이름을 사용합니다. 그래서 여기서는 camelCase, 웹훅 템플릿에서는 snake_case를 씁니다. `legacyResourceId`는 웹훅에서 `id`라고 부르는 것과 같은 숫자 ID입니다.

좋은 조합은 일반 웹훅을 `Low`로 두고, 대량 주문만 Flow가 `High`로 보내게 하는 것입니다. 누군가 지금 바로 처리해야 하는 주문이라면 `critical`을 사용하세요. 유료 플랜에서는 방해 금지 모드를 뚫고 오며, 무료 플랜에서는 `high`로 전송됩니다.

### 재고 부족

트리거 **상품 변형 재고 수량 변경됨**을 사용하고 조건 두 개를 설정하세요. 그러면 재고가 기준선을 넘어설 때 한 번만 알림이 옵니다. 기준선 아래로 떨어진 판매마다 알림이 오지는 않습니다.

- `productVariant.inventoryQuantity`가 `5`보다 작음
- `inventoryQuantityPrior`가 `5` 이상

그다음 같은 HTTP 요청 작업을 쓰고 본문은 다음과 같이 설정하세요.

```liquid
{
  "title": "Low stock: {{product.title}}",
  "message": "{{productVariant.title}}: {{productVariant.inventoryQuantity}} left",
  "level": "default"
}
```

두 본문 모두 주의할 점이 있습니다. Flow는 값을 그대로 삽입합니다. 상품명에 큰따옴표가 들어 있으면 잘못된 JSON이 만들어지고, API가 요청을 거부합니다. 제목은 평범한 문자로 두거나 해당 필드를 빼세요.

## 솔직한 한계

- **Pocket Alert는 Shopify 서명을 검증하지 않습니다.** Shopify는 각 웹훅에 HMAC 헤더로 서명합니다. Pocket Alert는 수신 URL로 보내진 JSON이면 무엇이든 받으므로, URL 자체가 비밀입니다. 공개된 곳에 올리지 마세요. 서명 검증이 필요하다면 중간에 서명을 확인하고 [Pocket Alert API](https://info.pocketalert.app/api/messages/create.html)를 호출하는 작은 함수를 두세요.
- **무료 플랜은 하루 50개 메시지에서 멈춥니다.** 그 이후에는 한도가 초기화될 때까지 Pocket Alert가 Shopify에 오류로 응답합니다. Shopify는 실패한 전송을 재시도하며, 웹훅이 계속 실패하면 Shopify가 삭제합니다. 하루 주문이 약 40건을 넘는다면 유료 플랜을 쓰세요. 그렇지 않으면 웹훅이 사라질 수 있습니다.
- **웹훅 제목은 고정됩니다.** 웹훅 푸시의 제목은 항상 "Webhook"과 웹훅 이름입니다. 원하는 제목을 쓰려면 위에서 보여준 대로 Flow와 API를 사용하세요.
- **iOS의 버튼 레이블은 일반적입니다.** 안드로이드에서는 설정한 레이블이 보이지만, iOS에서는 **Open**으로 표시됩니다.

## 아무것도 도착하지 않을 때

- **웹훅 기록 열기.** [콘솔](/webhooks)에서 웹훅 기록을 확인하세요. Shopify가 보낸 모든 요청이 헤더, 본문, 렌더링된 메시지, 상태와 함께 남아 있습니다. 목록이 비어 있다면 Shopify가 URL을 호출하지 않은 것입니다. URL을 전부 제대로 붙여넣었는지 확인하세요.
- **"Invalid JSON" 확인.** Shopify 웹훅 형식이 XML로 설정되어 있을 수 있습니다. Shopify에서 웹훅을 편집하고 형식을 JSON으로 바꾸세요.
- **푸시에 빈 필드가 있음.** 경로가 잘못되었거나 해당 주문에 그 필드가 없는 경우입니다. 템플릿을 기록의 본문과 비교해 보세요. 예를 들어 POS 주문에서는 `customer`가 비어 있을 수 있습니다.
- **Shopify에서 웹훅이 사라짐.** 연속으로 너무 많이 실패해서 생기는 일이며, 보통 잘못된 URL이나 일일 한도가 원인입니다. 원인을 해결한 뒤 다시 추가하세요.
- **Flow 요청 실패.** 워크플로의 실행 로그를 여세요. 401은 비밀 값의 키가 잘못되었다는 뜻이고, 400은 대개 본문이 올바른 JSON이 아니라는 뜻입니다.

## 자주 묻는 질문

### Shopify Basic 플랜에서도 되나요?

네. 기본 설정은 **설정 → 알림**의 웹훅 페이지만 사용합니다. Flow 섹션만 Grow, Advanced 또는 Plus 플랜이 필요합니다.

### 직원이 Shopify 계정 없이도 주문 푸시를 받을 수 있나요?

네. 푸시는 Pocket Alert 계정에 로그인한 휴대폰으로 전달되며, Shopify는 웹훅을 보내는 역할 외에는 관여하지 않습니다. 무료 플랜은 기기 1대를 허용하고, 유료 플랜은 더 많은 기기를 허용합니다.

### 스토어 두 곳의 주문을 받을 수 있나요?

스토어마다 웹훅을 하나씩 만들고 "Shopify EU", "Shopify US"처럼 각각 다른 이름을 붙이세요. 이름이 푸시 제목에 표시되어 구분할 수 있고, 각 웹훅을 서로 다른 Pocket Alert 애플리케이션으로 보낼 수도 있습니다.

### Stripe나 WooCommerce는 어떤가요?

Stripe에는 별도 가이드가 있습니다. [Stripe 결제 알림](/blog/stripe-payment-notifications)을 참고하세요. 다른 플랫폼의 경우 [이커머스 주문 알림](/use-cases/ecommerce-order-alerts) 페이지에 같은 방식이 나와 있고, JSON 웹훅을 보내는 서비스라면 [웹훅 도구](/tools/webhook)와 함께 사용할 수 있습니다.

[무료 계정 만들기](/signup)를 하고, Shopify에 URL 하나만 붙여넣어 보세요. 다음 주문 소식을 휴대폰에서 바로 받을 수 있습니다.
