# Tingkat Prioritas & Critical Alert

Setiap pesan Pocket Alert membawa tingkat prioritas yang menentukan seberapa keras notifikasi itu muncul: diam-diam di tray, sebagai banner biasa, atau sebagai critical alert yang membangunkan perangkat melewati tombol senyap dan Jangan Ganggu.

## Lima tingkat

| Level | Alias | Perilaku |
|-------|---------|----------|
| `silent` | `min`, `-2` | Hanya dikirim ke tray — tanpa suara, tanpa getar |
| `low` | `-1` | Senyap, tidak menginterupsi |
| `default` | `normal`, `0` (atau dihilangkan) | Banner standar + suara |
| `high` | `1` | Sensitif waktu — menembus Fokus dan ringkasan terjadwal |
| `critical` | `max`, `urgent`, `2` | Membangunkan perangkat melewati tombol senyap dan Jangan Ganggu |

Kedua penulisan berlaku di mana saja: kirim `"level": "critical"` atau `"level": 2`. Pada API [Create Message](https://info.pocketalert.app/api/messages/create.md), field ini juga diterima sebagai `priority`; webhook hanya membaca `level`.

## Apa yang dilakukan setiap tingkat di perangkat

**iOS** memetakan tingkat ke level interupsi APNs — `passive`, `active`, `time-sensitive`, dan `critical`. Alert `critical` menggunakan entitlement critical alert dari Apple, yang memutar suara pada volumenya sendiri meskipun dering dimatikan dan Jangan Ganggu aktif. iOS meminta izin **Critical Alerts** secara terpisah; jika izin ini dimatikan di **Pengaturan → Notifikasi → Pocket Alert**, pesan `critical` akan tiba sebagai `time-sensitive`.

**Android** memetakan tingkat ke channel notifikasi yang terpisah. `critical` menggunakan channel dengan tingkat kepentingan tinggi, melewati DND, serta full-screen intent, sehingga alert menguasai layar alih-alih menunggu di panel notifikasi.

Karena setiap tingkat adalah channel Android tersendiri, pengguna dapat membisukan notifikasi rutin Anda di pengaturan sistem sambil tetap mengaktifkan notifikasi kritis.

## Di mana Anda dapat mengaturnya

Prioritas ditentukan dengan urutan berikut; kecocokan pertama yang menang:

1. **Per pesan** — field `level` pada [Create Message](https://info.pocketalert.app/api/messages/create.md), pemilih prioritas di dasbor, atau field `level` di tingkat atas payload yang dikirim ke webhook.
2. **Per webhook** — level default pada webhook, untuk pesan yang masuk melaluinya, sehingga payload masuk langsung dipetakan ke tingkat keparahan.
3. **Per aplikasi** — level default pada aplikasi, diterapkan ke setiap pesan yang tidak mengatur levelnya sendiri.
4. **Cadangan** — `default`.

Urutan inilah yang membuat satu webhook berguna untuk peristiwa rutin maupun mendesak: atur webhook ke `high`, lalu biarkan panggilan individual menaikkannya ketika ada sesuatu yang benar-benar rusak.

## Batasan paket

> **Warning: Critical adalah fitur berbayar**
>
> Pada paket gratis, `critical` otomatis diturunkan menjadi `high` alih-alih ditolak — alert tetap sampai, hanya saja tidak menembus Jangan Ganggu. Semua tingkat lain berfungsi di setiap paket.

Nama level yang tidak dikenal atau int di luar `-2`..`2` mengembalikan `400`.

## Memfilter berdasarkan prioritas di aplikasi

Feed mobile membaca level yang sama. Ketuk ikon filter untuk memilih satu atau lebih level, mempersempit ke rentang tanggal, atau mengurutkan seluruh feed berdasarkan tingkat keparahan alih-alih waktu — berguna saat Anda kembali ke HP dengan empat puluh notifikasi dan hanya ingin melihat dua yang penting.

## Memilih level

Panduan singkat agar notifikasi tetap bisa dipercaya:

- **`critical`** — seseorang harus bertindak sekarang, kapan pun. Produksi mati, pelanggaran keamanan, freezer melewati suhu batas.
- **`high`** — perlu perhatian dalam satu jam. Deploy gagal, pembayaran ditolak, antrean menumpuk.
- **`default`** — penting diketahui hari ini. Build selesai, pendaftaran baru, formulir dikirim.
- **`low`** / **`silent`** — log yang masuk ke HP Anda. Cron selesai sesuai jadwal, backup malam selesai.

Tujuan tingkat prioritas bukan membuat setiap alert makin keras. Tujuannya agar alert yang keras benar-benar berarti.

## Terkait

- [Create Message](https://info.pocketalert.app/api/messages/create.md) — field `level` dan referensi permintaan lengkap
- [Tombol aksi](https://info.pocketalert.app/features/action-buttons.md) — bertindak atas alert tanpa membuka aplikasi
- [Pengiriman terjadwal](https://info.pocketalert.app/features/scheduled-delivery.md) — kirim sekarang, kirimkan nanti
