# 優先度レベルとクリティカルアラート

Pocket Alert のすべてのメッセージには優先度レベルが設定されており、通知がどれだけ目立つかを決めます。通知センターに静かに届くもの、通常のバナーとして表示されるもの、そして消音スイッチやおやすみモードを越えてデバイスを起こすクリティカルアラートのいずれかになります。

## 5 つのレベル

| レベル | 別名 | 動作 |
|-------|---------|----------|
| `silent` | `min`, `-2` | 通知センターにのみ届きます。音もバイブレーションもありません |
| `low` | `-1` | 控えめに表示され、割り込みません |
| `default` | `normal`, `0`（または省略） | 標準のバナーと通知音 |
| `high` | `1` | 時間的に重要です。集中モードと予約サマリーを越えて表示されます |
| `critical` | `max`, `urgent`, `2` | 消音スイッチとおやすみモードを越えてデバイスを起こします |

どちらの書き方もすべての場所で使えます。`"level": "critical"` でも `"level": 2` でも送信できます。[Create Message](https://info.pocketalert.app/api/messages/create.md) API では、このフィールドは `priority` という名前でも受け付けます。Webhook が読み取るのは `level` のみです。

## 各レベルがデバイス上でどう動くか

**iOS** では、レベルを APNs の割り込みレベル（`passive`、`active`、`time-sensitive`、`critical`）に対応付けます。`critical` のアラートは Apple のクリティカルアラートの権限を使うため、着信音が OFF でおやすみモードが ON のときでも、独自の音量で音が鳴ります。iOS は別途 **クリティカルアラート** の許可を求めます。これを **設定 → 通知 → Pocket Alert** でオフにしている場合、`critical` のメッセージは `time-sensitive` として届きます。

**Android** では、レベルごとに別々の通知チャンネルを使います。`critical` は重要度の高いチャンネルを使い、おやすみモードを無視して全画面インテントを発動します。そのためアラートは通知シェードに留まらず、画面全体に表示されます。

各レベルは Android で別チャンネルになっているため、ユーザーは定期的な通知だけをシステム設定でミュートし、クリティカルな通知は有効なままにできます。

## 設定する場所

優先度は次の順序で決まり、最初に一致したものが適用されます。

1. **メッセージごと** — [Create Message](https://info.pocketalert.app/api/messages/create.md) の `level` フィールド、ダッシュボードの優先度セレクター、または Webhook に送るペイロードのトップレベルの `level` フィールド。
2. **Webhook ごと** — Webhook に設定するデフォルトのレベルです。そのWebhook経由で届くメッセージに適用されるため、受信したペイロードをそのまま重大度に対応付けられます。
3. **アプリケーションごと** — アプリケーションに設定するデフォルトのレベルです。独自に設定していないすべてのメッセージに適用されます。
4. **フォールバック** — `default`。

この順序のおかげで、1 つの Webhook で定例の通知と緊急の通知の両方を扱えます。Webhook を `high` に設定しておき、実際に障害が起きたときだけ個別の呼び出しで上位のレベルに上書きすれば十分です。

## プランごとの制限

> **Warning: クリティカルは有料機能です**
>
> 無料プランでは、`critical` は拒否されず自動的に `high` に格下げされます。アラートは届きますが、おやすみモードを越えることはありません。それ以外のレベルはすべてのプランで利用できます。

存在しないレベル名や、`-2`..`2` の範囲外の整数を指定すると `400` が返されます。

## アプリで優先度によって絞り込む

モバイルのフィードも同じレベルを使います。フィルターアイコンをタップすると、1 つまたは複数のレベルを選択したり、日付範囲で絞り込んだり、時刻ではなく重大度順にフィード全体を並べ替えたりできます。通知が 40 件たまったスマホを見直して、本当に重要な 2 件だけを探したいときに便利です。

## レベルの選び方

通知を信頼できるものに保つための目安は次のとおりです。

- **`critical`** — 時間帯に関係なく、今すぐ誰かが対応しなければならない場合です。本番環境の停止、セキュリティ侵害、冷凍庫の温度異常などが該当します。
- **`high`** — 1 時間以内に気づく必要がある場合です。デプロイの失敗、決済の拒否、キューの滞留などが該当します。
- **`default`** — 今日中に知っておくと良い場合です。ビルドの完了、新規登録、フォームの送信などが該当します。
- **`low`** / **`silent`** — スマホへの記録として残す場合です。cron ジョブが予定どおり完了した、夜間バックアップが終わった、などが該当します。

優先度レベルの目的は、すべてのアラートを大きくすることではありません。大きな通知に本当に意味を持たせることです。

## 関連ページ

- [Create Message](https://info.pocketalert.app/api/messages/create.md) — `level` フィールドと完全なリクエストのリファレンス
- [アクションボタン](https://info.pocketalert.app/features/action-buttons.md) — アプリを開かずにアラートに対応する
- [予約送信](https://info.pocketalert.app/features/scheduled-delivery.md) — 今送信して、あとで届ける
