# 바로 알림으로 판매가 들어오면.

> Shopify, WooCommerce, Stripe 주문이 들어올 때마다 푸시 알림을 받아보세요. 스토어 웹훅을 Pocket Alert에 연결하면 판매와 환불을 바로바로 확인할 수 있어요.

<!-- source: https://pocketalert.app/ko/use-cases/ecommerce-order-alerts -->

마지막 업데이트: 2026-08-11

Shopify, WooCommerce 또는 직접 운영하는 스토어의 새 주문이 주문 번호, 총액, 고객 정보와 함께 휴대폰에 도착합니다. 판매가 들어오는 순간 바로 확인하세요.

## 주문 알림까지 3단계

1. **웹훅 만들기** — order_number, total_price, customer를 매핑하는 GJSON 템플릿으로 Pocket Alert 웹훅을 만들고, 수신 URL을 복사하세요.
2. **스토어 연결하기** — Shopify에서 Order creation 이벤트용 웹훅을 추가하고, 대상으로 수신 URL을 붙여넣으세요.
3. **주문 알림 확인하기** — 테스트 주문을 넣어보세요. 판매 알림에 총액과 고객 정보가 담겨 휴대폰에 도착합니다.

## 내 스토어를 휴대폰에서 한눈에

스토어가 웹훅을 보내는 순간, 모든 판매, 환불, 결제 실패가 휴대폰으로 바로 전달됩니다.

- **어떤 스토어든, 플러그인 없이** — Shopify, WooCommerce, Stripe, Paddle 또는 맞춤형 스토어가 주문 웹훅을 Pocket Alert URL로 바로 보냅니다.
- **총액과 고객 정보** — 주문 금액, 고객, 상품을 매핑해서 원시 이벤트가 아니라 실제 영수증처럼 읽히는 알림을 만듭니다.
- **판매, 환불, 실패** — 새 주문, 환불, 결제 실패가 각각 별도의 푸시 알림으로 발송되며, 모두 같은 스토어 웹훅에서 시작됩니다.
- **환불은 별도 채널로** — refunds/create 전용 웹훅을 별도 애플리케이션에 연결하면 일반 주문과 구분되어 울리므로, 환불이 판매 알림 사이에 묻히지 않습니다.
- **1초 이내** — 주문이 스토어를 떠나 1초 안에 휴대폰에 도착합니다. 대시보드를 새로고침할 필요가 없습니다.
- **스토어당 채널 하나** — 스토어마다 별도의 애플리케이션을 연결하면, 브랜드 두 개가 서로 구분되는 채널 두 개로 알려줍니다.

## Shopify 연결하기

### 1. Pocket Alert 웹훅 만들기

이름과 Shopify orders/create 페이로드를 매핑하는 GJSON `message` 템플릿을 정의하세요. 이렇게 하면 수신 URL이 반환됩니다.

```
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Shopify Orders","application_id":"qm47b9pzxzxg","message":"Order #%order_number% · %total_price% %currency% · %customer.first_name% %customer.last_name%"}'
```

응답에는 slug가 포함되어 있으며, 수신 URL은 `https://p4a.me/wh/1234abcd`입니다. [웹훅](https://pocketalert.app/ko/webhooks) 페이지에서도 만들 수 있습니다.

### 2. Shopify에 수신 URL 붙여넣기

Shopify에서 설정, 알림, 웹훅으로 이동한 다음 웹훅 만들기를 클릭하세요. `Order creation` 이벤트와 JSON 형식을 선택하고, 대상으로 Pocket Alert 수신 URL을 붙여넣으세요.

### 3. 필드 매핑하기

Shopify는 주문 JSON을 수신 URL로 POST합니다. 템플릿은 이 데이터를 기준으로 렌더링됩니다: `%order_number%`, `%total_price%`, `%currency%`, `%customer.email%`, 그리고 첫 번째 상품의 `%line_items.0.title%`. GJSON 경로 전체 목록은 [문서](https://info.pocketalert.app/api/webhooks/settings.html)에서 확인할 수 있습니다.

## 자주 묻는 질문

### 새 주문 알림은 어떻게 받나요?

Pocket Alert에서 메시지 템플릿을 포함한 웹훅을 만든 다음, 수신 URL을 Shopify의 설정, 알림, 웹훅 메뉴에 붙여넣으세요. Shopify가 주문이 들어올 때마다 orders/create 웹훅을 보내고, Pocket Alert가 이를 푸시 알림으로 변환합니다.

### 알림에 총액과 고객 이름도 표시할 수 있나요?

네. GJSON 템플릿이 Shopify 페이로드에서 %order_number%, %total_price%, %currency%, %customer.first_name% 필드를 직접 가져오므로, 알림에는 "Order #1001 · 125.00 USD · Jane"처럼 표시됩니다.

### 어떤 플랫폼을 지원하나요?

Shopify, WooCommerce, BigCommerce, 그리고 웹훅을 POST로 보내는 모든 맞춤형 스토어에서 사용할 수 있습니다. 플랫폼에 기본으로 포함된 웹훅 외에는 플러그인 없이, 템플릿에서 각 플랫폼의 페이로드 필드를 매핑하면 됩니다.

### 환불을 일반 판매와 구분할 수 있나요?

네. orders/create용 Pocket Alert 웹훅과 refunds/create용 웹훅을 각각 다른 애플리케이션으로 만드세요. 환불 알림은 일반 판매와 구분되는 채널로 울립니다.

### 스토어를 두 개 운영하는데 따로 관리할 수 있나요?

스토어마다 별도의 Pocket Alert 애플리케이션을 만드세요. 브랜드 두 개는 채널 두 개로 나뉘고, 푸시 알림에서 어느 쪽 주문인지 바로 알 수 있습니다.

### 큰 주문만 더 크게 알려줄 수 있나요?

네. 모든 메시지에는 silent(-2)부터 critical(2)까지 중요도를 설정할 수 있습니다. 백엔드에서 큰 금액의 주문을 level high로 보내면 iPhone 집중 모드도 뚫고 들어가는 시간 민감 푸시로 도착하고, 매일 밤 silent로 보내는 매출 요약은 소리 없이 기록에만 남습니다. 웹훅에도 default_level을 설정할 수 있어서, 고액 주문 웹훅은 일반 알림과 다르게 울리도록 구성할 수 있습니다.
