# 어떤 웹훅이든 휴대폰으로, 즉시.

> 어떤 웹훅이든 휴대폰 푸시 알림으로 바꿔 보세요. Stripe, GitHub, Zapier, n8n에서 Pocket Alert URL로 POST만 보내면 1초도 안 돼서 휴대폰으로 이벤트를 확인할 수 있어요.

<!-- source: https://pocketalert.app/ko/use-cases/webhook-notifications -->

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

Pocket Alert은 HTTP 웹훅을 아이폰이나 안드로이드의 푸시 알림으로 바꿔 줘요. Stripe, GitHub, n8n, 또는 직접 운영하는 백엔드를 수신 URL에 연결하면 이벤트가 1초 이내에 휴대폰에 도착해요. 중간 미들웨어도, 이메일 요약도 필요 없어요.

## 첫 웹훅 푸시까지 세 단계

1. **웹훅 만들기** — 웹훅 페이지에서 GJSON 메시지 템플릿으로 웹훅을 만드세요.
2. **이벤트 POST하기** — 수신 URL을 복사한 뒤, 어떤 서비스에서든 또는 curl로 JSON 본문을 POST하세요.
3. **푸시 알림 받기** — 휴대폰이 울려요. GJSON 플레이스홀더가 중첩된 페이로드 필드를 푸시 알림에 담아 줘요.

## 휴대폰에 도착하는 웹훅

Pocket Alert은 이미 발생하고 있는 웹훅을 휴대폰의 푸시 알림으로 바꿔 줘요.

- **순수 HTTP, SDK 불필요** — HTTP POST 한 번이면 충분해요. 페이로드가 도착하는 즉시 푸시 알림이 돼요.
- **어떤 것이든 연결** — Stripe, GitHub, Sentry, Zapier, Make, n8n, IFTTT, 직접 운영하는 백엔드까지 모두 웹훅을 사용해요. 여기서 전부 작동해요.
- **어떤 페이로드든 매핑** — 메시지 템플릿의 GJSON 플레이스홀더가 중첩된 JSON에서 값을 꺼내서, 푸시에는 중요한 내용만 보여줘요.
- **중간 미들웨어 생략** — 원본 서비스에서 URL을 바로 지정하거나, 데이터 형식을 바꿔야 할 때만 자동화 도구를 거치세요.
- **범위 제한 및 보안** — 수신 URL은 하나의 웹훅과 애플리케이션에 한정되고, 추측할 수 없는 슬러그를 쓰며, HTTPS로 동작해요.
- **1초 이내 전달** — 수신한 웹훅은 1초 이내에 아이폰이나 안드로이드에 도착해요.

## 첫 웹훅 보내기

### 1. 웹훅 만들기

[Webhooks](https://pocketalert.app/ko/webhooks) 페이지에서 또는 API로 웹훅을 만드세요. 이때 `name`, `application_id`, 그리고 들어오는 페이로드에 대해 GJSON 플레이스홀더를 사용하는 `message` 템플릿을 지정해요:

```
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"GitHub Push","message":"Push to %repository.name%: %head_commit.message%","application_id":"qm47b9pzxzxg"}'
```

### 2. 수신 URL 복사하기

Pocket Alert은 고유 슬러그가 포함된 수신 URL을 반환해요. 서비스는 여기에 자체 JSON을 POST하면 돼요:

```
https://p4a.me/wh/1234abcd
```

### 3. 서비스에서 이 URL 지정하기

수신 URL을 Stripe 웹훅, GitHub 웹훅, 또는 Make / n8n의 HTTP 단계에 붙여 넣으세요. 웹훅이 실행되면 Pocket Alert이 페이로드에 맞춰 템플릿을 렌더링해요. GJSON 경로로 중첩 필드(`%object.field%`), 배열 항목(`%items.0.name%`), 개수(`%users.#%`), 또는 전체 본문(`*`)에 접근할 수 있어요. 모든 플레이스홀더는 [웹훅 설정 문서](https://info.pocketalert.app/api/webhooks/settings.html)에서 확인하세요.

### 4. 음량 설정하기

발신 서비스의 JSON에 `"level"` 필드를 넣으면 — `silent`부터 `critical`까지 — 푸시가 그 우선순위를 따라요. 그래서 결제 실패는 [방해 금지 모드를 뚫고](https://pocketalert.app/ko/use-cases/critical-alerts) 도착하고, 일상적인 알림은 조용히 머물 수 있어요. 또는 웹훅에 `default_level`을 한 번 설정해 두고 잊어버려도 돼요.

## 자주 묻는 질문

### 웹훅 푸시는 어떻게 작동하나요?

Pocket Alert에서 메시지 템플릿과 함께 웹훅을 만들면 https://p4a.me/wh/1234abcd 같은 수신 URL이 발급돼요. HTTP POST를 보낼 수 있는 서비스라면 무엇이든 이 URL을 호출할 수 있어요. Stripe, GitHub, Make, n8n, 직접 운영하는 백엔드 모두 가능해요. 전달된 페이로드는 휴대폰의 푸시 알림으로 표시돼요.

### 커스텀 페이로드로 알림 형식을 바꿀 수 있나요?

네. 메시지 템플릿에서 %repository.name%이나 %head_commit.message% 같은 GJSON 플레이스홀더를 사용하면 중첩된 JSON에서 값을 꺼낼 수 있어요. 그래서 Stripe 이벤트나 GitHub 페이로드에서 필요한 필드만 정확히 표시할 수 있어요.

### 어떤 서비스를 연결할 수 있나요?

HTTP 요청을 보낼 수 있는 서비스라면 모두 연결할 수 있어요. Stripe, GitHub, GitLab, Sentry, Zapier, Make.com, n8n, IFTTT, 직접 만든 스크립트까지 가능해요.

### 중간에 Zapier나 Make가 꼭 필요한가요?

원본 서비스에서 Pocket Alert 웹훅 URL을 바로 지정하면 돼요. 데이터를 먼저 변환해야 한다면 Zapier나 Make를 거쳐 전달할 수도 있어요.

### 웹훅 URL은 안전한가요?

수신 URL마다 하나의 웹훅과 하나의 애플리케이션에 연결되고, 슬러그는 추측할 수 없어요. 트래픽은 HTTPS로 전송되며, 웹훅 페이지에서 언제든지 웹훅을 삭제하고 다시 만들 수 있어요.

### 웹훅으로 알림의 음량을 조절할 수 있나요?

네. 서비스가 보내는 JSON에 "level" 필드를 넣으세요. 값은 silent, low, default, high, critical 중 하나예요. 푸시는 그 우선순위를 따라요. critical 웹훅은 안드로이드에서 방해 금지 모드를 뚫고, 아이폰에서는 집중 모드를 통과해요. 웹훅 자체에 default_level을 설정하면 발신 측을 건드리지 않고도 전달되는 모든 알림의 음량을 맞출 수 있어요.
