# プッシュ通知 で、その場で操作できる 。

> Pocket Alert のプッシュ通知にアクションボタンを追加できます。URL を開く、HTTP リクエストを送る、テキストをコピーする、といった操作をロック画面からそのまま実行。デプロイや AI エージェントのワンタップ承認ワークフローも作れます。

<!-- source: https://pocketalert.app/ja/features/action-buttons -->

最終更新日:2026-10-25

どのプッシュ通知にも最大 3 つのボタンを付けられます。リンクを開く、HTTP リクエストを送る、値をコピーする。スマホのロックを解除したり、パソコンを開いたりする必要はありません。

ドキュメント:https://info.pocketalert.app/features/action-buttons.html

## 通知から、ワンタップの操作へ

1. **種類を選ぶ** — ボタンの動作を決めます。URL を開く、エンドポイントを呼び出す、値をコピーする、のいずれかです。
2. **メッセージに追加する** — メッセージに actions 配列を追加し、type、label、value を指定したエントリーを最大 3 つ入れます。
3. **スマホでタップする** — 送信すると、ボタンが通知とアプリ内のメッセージに表示されます。

## 3 種類のボタン、1 つの配列

何かが起きたことだけを伝える通知では、対応のために別の場所へ移動する必要があります。ボタンはそのギャップを埋めます。

- **目的の画面へすぐ移動** — view ボタンで URL を開けます。失敗したビルド、注文、ダッシュボードなどを、タブを探さずに直接開けます。
- **バックグラウンドでリクエストを実行** — http ボタンは、指定したメソッド、ヘッダー、ボディでリクエストを送信します。サービスの再起動やインシデントの確認を 1 タップで行えます。
- **面倒な操作なしでコピー** — copy ボタンで値をクリップボードにコピーできます。ワンタイムコード、インシデント ID、トークンを、スマホ上でテキストを選択せずにコピーできます。
- **承認ワークフロー** — 「Approve」と「Decline」の 2 つの http ボタンを使えば、人の判断を待つ処理をワンタップで操作できるコントロールパネルに変えられます。
- **バナーが消えても残る** — ボタンはバナーだけでなくメッセージ内にも表示されます。通知をスワイプして消しても、後からメッセージを開けばボタンは残っています。
- **Webhook からボタンを生成** — Webhook のテンプレートは、受信したペイロードからボタンの URL を埋めます。そのためアラートごとに、対応する issue、注文、ビルドへのリンクが付きます。

## アクションボタンの仕組み

    
API、Webhook、MCP サーバーから送るメッセージには、どれでも `actions` 配列を追加できます。各エントリーには `type`、`label`、`value` があります。`value` の意味は種類によって異なり、`view` では URL、`http` では JSON のリクエスト定義、`copy` では文字列そのものになります。

    
ボタンはプッシュ通知と一緒に配信され、OS によって表示されます。タップすると、アプリがその場で処理します。`http` と `copy` は何も開かずに実行され、`view` ではブラウザが前面に表示されます。

    
## 承認パターン

    
最初に作る価値があるのは、「Approve」と「Decline」の 2 つの `http` ボタンで、それぞれ自分のエンドポイントを指す構成です。人の確認を待って止まる処理なら何にでも合います。手動の承認を待つデプロイパイプライン、一定額を超える返金、本番環境に監視なしで触れさせるべきでない AI エージェントなどが該当します。

    
リクエストはスマホからエンドポイントへ直接送られるため、その URL の先にあるものは、認証を含めてすべてご自身で管理できます。

    
## 知っておくべき制限

    
ボタンは最大 3 つです。`view` と `http` には有効な http(s) URL が必要で、それ以外は `400` を返します。ボタンは、アプリが開いている、バックグラウンドにある、閉じている、のいずれの場合もシステムの通知上で動作します。ただし Pocket Alert 2.0.1 以降が必要です。古いバージョンのアプリでは、メッセージ内にだけ表示されます。

## よくある質問

### 1 つの通知に付けられるボタンは何個までですか？

1 つのメッセージにつき 3 つまでです。iOS と Android のどちらでも送った順に表示され、バナーを閉じた後もメッセージ内から引き続き使えます。

### ボタンではどんな操作ができますか？

3 種類あります。`view` は URL を開き、`http` は指定したメソッド、ヘッダー、ボディで HTTP リクエストをバックグラウンドで送信し、`copy` は値をクリップボードにコピーします。アプリを前面に表示するのは `view` だけです。

### HTTP ボタンのリクエストはどこへ送られますか？

スマホからエンドポイントへ直接送信されます。Pocket Alert がリクエストを中継することはなく、レスポンスの本文も見ることはありません。エンドポイントが必要とする認証ヘッダーを付ければ、そのままボタンに付随して送信されます。

### iPhone でもボタンのラベルは表示されますか？

はい。iPhone でも Android でも、送信したラベルがそのまま通知とメッセージ内に表示されます。iOS でカスタムボタンの準備が間に合わない場合は、種類ごとの汎用ラベル（Open、Run、Copy）に切り替わりますが、ボタン自体は引き続き動作します。

### Webhook でボタンを自動で追加できますか？

はい。Webhook には、受信したペイロードから `%path%` プレースホルダーを埋めるアクションテンプレートを含められます。そのため Sentry のアラートには、該当の issue を指す「Open issue」ボタンが付いて届きます。埋め込まれる値は JSON エスケープされるため、ペイロードで URL を書き換えられることはありません。

### ボタンを 2 回タップするとどうなりますか？

2 回タップすると、リクエストも 2 回送信されます。繰り返しは意図的にブロックしていません。2 回実行すると問題になる場合は、エンドポイントを冪等にしてください。アクションボタンは有料機能です。無料プランではサーバー側で取り除かれ、ボタンなしでメッセージが届きます。
