# デプロイが完了した瞬間 に通知が届きます。

> デプロイの成功・失敗をプッシュ通知でお知らせ。GitHub Actions、GitLab CI、Jenkins にステップを 1 つ追加するだけで、デプロイ結果が数秒でスマホに届きます。

<!-- source: https://pocketalert.app/ja/use-cases/deployment-alerts -->

最終更新日:2026-08-11

GitHub Actions、GitLab CI、Jenkins に通知ステップを 1 つ追加するか、Vercel または Netlify のデプロイ Webhook を Pocket Alert に向けてください。ジョブが終わってから 1 秒以内に、コミット、ブランチ、環境の情報を添えてデプロイ結果がスマホに届きます。

## デプロイ通知を設定する 3 つのステップ

1. **API キーまたは Webhook URL を取得** — CLI や curl の呼び出し用に API キーを作成するか、Webhook を作成して受信 URL をコピーします。
2. **ステップまたは Webhook を追加** — パイプラインに通知ステップを追加するか、Vercel または Netlify のデプロイ通知に受信 URL を貼り付けます。
3. **安心してリリース** — リリースすると、結果、コミット、環境を伝える通知がスマホに届きます。

## すべてのリリースをスマホで確認

リリースが静かに失敗しても、ユーザーから壊れたサイトの報告を受けるずっと前に、数秒で気づけます。

- **どのパイプラインにも組み込める** — GitHub Actions、GitLab CI、Jenkins、CircleCI はいずれも、パイプラインの末尾に 1 ステップ追加するだけで使えます。
- **成功と失敗を選んで通知** — 成功時、失敗時、またはその両方で送信できます。if: failure() で通知ステップを実行すれば、壊れたリリースの通知だけを受け取れます。
- **デプロイの詳細情報** — メッセージにコミット、ブランチ、環境、実行 URL を含めれば、何がリリースされたかをすぐに把握できます。
- **環境ごとのチャンネル** — 環境ごとにアプリケーションを分ければ、本番、ステージング、プレビューのデプロイをそれぞれ別のチャンネルで受け取れます。
- **完了と同時に通知** — ジョブが終わった時点でプッシュ通知が届くため、パイプラインのタブを閉じても結果がわかります。
- **設定はほぼ不要** — ジョブに CLI を 1 回呼び出すか curl を 1 行書くだけで設定できます。Slack ボットをインストールする必要もありません。

## すべてのデプロイで通知を受け取る

### 1. CI/CD パイプライン（CLI または curl）

GitHub Actions、GitLab CI、Jenkins、CircleCI のジョブ末尾に 1 ステップ追加してください。CLI を使う場合は次のとおりです。

```
pocketalert send -t "Deploy succeeded" -m "prod @ v2.4.0"
```

または、ランナーに何もインストールせずに済むよう、メッセージ API を curl で直接呼び出せます。

```
curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Deploy succeeded","message":"prod @ v2.4.0","level":"silent"}'
```

### 2. Vercel または Netlify（Webhook）

Webhook を作成すると、Vercel または Netlify が自身のデプロイ情報を Pocket Alert に POST できます。`message` フィールドは GJSON テンプレートで、相手のフィールドをプッシュ通知の内容に割り当てます。

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Vercel deploy","message":"%type%: %payload.project.name% on %payload.deployment.target%","application_id":"qm47b9pzxzxg"}'
```

受信 URL は `https://p4a.me/wh/1234abcd` のような形式です。これを Vercel の Webhook 設定に貼り付けてください（`deployment.succeeded` などのイベントを指定します）。Netlify の場合は、デプロイ通知の送信 Webhook として追加し、`%name% is %state% on %branch%` のようにフィールドを割り当ててください。

メッセージ API と GJSON のフィールド割り当てについては、[Webhook 設定のドキュメント](https://info.pocketalert.app/api/webhooks/settings.html)をご覧ください。

## よくある質問

### デプロイ通知はどう設定すればよいですか？

GitHub Actions、GitLab CI、Jenkins、CircleCI のパイプライン末尾に通知ステップを追加します。Pocket Alert CLI か curl を実行すると、ジョブが終わった時点でデプロイ結果がプッシュ通知として届きます。

### デプロイ失敗時だけ通知を受け取れますか？

はい。ジョブのステータスを使って成功時と失敗時で異なるメッセージを送れます。通知ステップを if: failure() の条件でだけ実行すれば、届く通知は壊れたリリースのものだけになります。

### コミットや環境の情報も含められますか？

メッセージ本文にコミット、ブランチ、環境、パイプラインの URL を含めてください。通知を見れば何がどこにリリースされたかがわかり、そのまま実行結果にも移動できます。

### 対応している CI/CD ツールは？

コマンドを実行できる仕組みならどれでも使えます。GitHub Actions、GitLab CI、Jenkins、CircleCI、Bitbucket Pipelines、通常のデプロイスクリプトなどです。Vercel と Netlify の場合は Pocket Alert で Webhook を作成し、その受信 URL をそれぞれのデプロイ通知設定に貼り付けてください。

### 本番とステージングの通知を分けられますか？

本番、ステージング、プレビューごとにアプリケーションを分けて作成してください。本番デプロイは専用のチャンネルに届くため、リリースの種類をひと目で見分けられます。

### 本番デプロイの失敗はおやすみモードを突破して通知されますか？

はい。デプロイ失敗時は level=critical で送信してください。Android では、おやすみモードを突破する専用チャンネルに届きます。iPhone では、集中モードを突破する時間順守の通知として表示されます。日常的な成功通知は level=silent で送れば、振動せず履歴に残るだけになります。
