# どんな Webhook も スマホに 、すぐに届けます。

> あらゆる Webhook をスマホのプッシュ通知に。Stripe、GitHub、Zapier、n8n から Pocket Alert の URL に POST するだけで、イベントを1秒以内にスマホで確認できます。

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

最終更新日:2026-08-11

Pocket Alert は、どの HTTP Webhook も iPhone や Android のプッシュ通知に変換します。Stripe、GitHub、n8n、自社のバックエンドを受信 URL に向けるだけで、イベントは 1 秒未満でスマホに届きます。中継サーバーもメールのダイジェストも不要です。

## 最初の Webhook プッシュまでの 3 ステップ

1. **Webhook を作成する** — Webhook ページで、GJSON のメッセージテンプレート付きの Webhook を作成します。
2. **イベントを POST する** — 受信 URL をコピーし、任意のサービスまたは curl から JSON ボディを POST します。
3. **プッシュ通知を受け取る** — スマホが振動します。GJSON プレースホルダーが、ネストしたペイロードのフィールドを通知に表示します。

## スマホに届く Webhook 通知

Pocket Alert は、すでに送信している Webhook をスマホのプッシュ通知に変換します。

- **素の HTTP、SDK 不要** — HTTP POST を 1 回送るだけで済みます。ペイロードは届いた瞬間にプッシュ通知になります。
- **あらゆるサービスと連携** — Stripe、GitHub、Sentry、Zapier、Make、n8n、IFTTT、自社のバックエンドはいずれも Webhook に対応しており、すべてここで利用できます。
- **どんなペイロードにも対応** — メッセージテンプレートの GJSON プレースホルダーでネストした JSON から値を取り出すため、通知には必要な情報だけを表示できます。
- **中継サーバーは不要** — 送信元のサービスに URL を直接設定できます。データの形を整える必要がある場合だけ、自動化ツールを経由させてください。
- **範囲を限定し安全に** — 各受信 URL は 1 つの Webhook とアプリケーションに限定され、推測されにくいスラッグを持ち、HTTPS で通信します。
- **1 秒未満で配信** — 受信した Webhook は 1 秒未満で iPhone や Android に届きます。

## 最初の Webhook を送信する

### 1. Webhook を作成する

[Webhook](https://pocketalert.app/ja/webhooks) ページ、または API で、`name`、`application_id`、そして受信ペイロードを GJSON プレースホルダーで参照する `message` テンプレートを指定して Webhook を作成します。

```
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 の Webhook、GitHub の Webhook、または Make / n8n の HTTP ステップに貼り付けます。イベントが発生すると、Pocket Alert がペイロードに対してテンプレートを展開します。GJSON のパスでは、ネストしたフィールド（`%object.field%`）、配列の要素（`%items.0.name%`）、件数（`%users.#%`）、ボディ全体（`*`）を指定できます。すべてのプレースホルダーについては、[Webhook 設定のドキュメント](https://info.pocketalert.app/api/webhooks/settings.html)をご覧ください。

### 4. 音量を設定する

送信元が JSON に `"level"` フィールドを含めると（`silent` から `critical` まで）、その優先度で通知されます。たとえば支払い失敗は[おやすみモードを突破](https://pocketalert.app/ja/use-cases/critical-alerts)させ、定期的な通知は静かに届けられます。あるいは Webhook に `default_level` を一度設定しておけば、以後は意識する必要がありません。

## よくある質問

### Webhook からプッシュ通知までの仕組みは？

Pocket Alert でメッセージテンプレート付きの Webhook を作成すると、https://p4a.me/wh/1234abcd のような受信 URL が発行されます。HTTP POST を送信できるサービスなら、Stripe、GitHub、Make、n8n、自社のバックエンドなど、どれでもこの URL に送れます。受信したペイロードは、スマホに届くプッシュ通知として表示されます。

### カスタムペイロードから通知の内容を整えられますか？

はい。メッセージテンプレートでは %repository.name% や %head_commit.message% といった GJSON プレースホルダーを使えるため、ネストした JSON から値を取り出せます。Stripe のイベントや GitHub のペイロードでも、必要なフィールドだけを通知に表示できます。

### どのサービスと連携できますか？

HTTP リクエストを送信できるものなら何でも利用できます。Stripe、GitHub、GitLab、Sentry、Zapier、Make.com、n8n、IFTTT、独自のスクリプトなどが対象です。

### 間に Zapier や Make を挟む必要はありますか？

送信元のサービスに Pocket Alert の Webhook URL を直接設定できます。データを事前に加工する必要がある場合は、Zapier や Make を経由させることもできます。

### Webhook URL は安全ですか？

受信 URL はそれぞれ 1 つの Webhook と 1 つのアプリケーションに紐づき、スラッグは推測されにくい値です。通信は HTTPS で行われ、Webhook ページからいつでも削除して作り直せます。

### Webhook で通知の音量を制御できますか？

はい。サービスが送信する JSON に "level" フィールドを含めてください。値は silent、low、default、high、critical のいずれかです。その値に応じて通知の優先度が決まります。critical の Webhook は、Android ではおやすみモードを突破し、iPhone では集中モードでも通知が届きます。Webhook 自体に default_level を設定すれば、送信元を変更しなくても、転送されるすべての通知を適切な音量で届けられます。
