アクションボタン

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

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

最大3 つのボタンview · http · copyiOS & Android 更新
できること

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

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

目的の画面へすぐ移動

view ボタンで URL を開けます。失敗したビルド、注文、ダッシュボードなどを、タブを探さずに直接開けます。

バックグラウンドでリクエストを実行

http ボタンは、指定したメソッド、ヘッダー、ボディでリクエストを送信します。サービスの再起動やインシデントの確認を 1 タップで行えます。

面倒な操作なしでコピー

copy ボタンで値をクリップボードにコピーできます。ワンタイムコード、インシデント ID、トークンを、スマホ上でテキストを選択せずにコピーできます。

承認ワークフロー

「Approve」と「Decline」の 2 つの http ボタンを使えば、人の判断を待つ処理をワンタップで操作できるコントロールパネルに変えられます。

バナーが消えても残る

ボタンはバナーだけでなくメッセージ内にも表示されます。通知をスワイプして消しても、後からメッセージを開けばボタンは残っています。

Webhook からボタンを生成

Webhook のテンプレートは、受信したペイロードからボタンの URL を埋めます。そのためアラートごとに、対応する issue、注文、ビルドへのリンクが付きます。

はじめ方

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

1

種類を選ぶ

ボタンの動作を決めます。URL を開く、エンドポイントを呼び出す、値をコピーする、のいずれかです。

2

メッセージに追加する

メッセージに actions 配列を追加し、type、label、value を指定したエントリーを最大 3 つ入れます。

3

スマホでタップする

送信すると、ボタンが通知とアプリ内のメッセージに表示されます。

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

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 以降が必要です。古いバージョンのアプリでは、メッセージ内にだけ表示されます。

FAQ

よくある質問

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

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

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

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

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

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

アラートを読むだけでなく、その場で応答しましょう。

次に送るメッセージに actions 配列を追加すると、通知は読むだけのものではなくなります。タップして操作するものになります。