# Action Buttons

Sebuah notifikasi dapat memuat hingga tiga tombol. Alih-alih membaca peringatan lalu membuka laptop untuk menanganinya, Anda bisa langsung bertindak dari layar kunci: buka run, jalankan restart, salin kode.

## Tiga jenis tombol

| Jenis | Fungsi tombol | Isi `value` |
|-------|---------------|-------------|
| `view` | Membuka URL | URL-nya, misalnya `https://status.example.com` |
| `http` | Mengirim permintaan HTTP di latar belakang | String JSON: `{"url":"…","method":"POST","headers":{…},"body":"…"}` |
| `copy` | Menyalin teks ke clipboard | Teks literal yang akan disalin |

Untuk `http`, hanya `url` yang wajib diisi — `method` default-nya `GET`. Jika `body` ada dan tidak ada content type yang diatur, `Content-Type: application/json` ditambahkan secara otomatis.

`http` dan `copy` berjalan tanpa membuka aplikasi, bahkan saat aplikasi sedang ditutup. `view` membawa aplikasi atau browser ke latar depan.

## Tempat tombol muncul

Tombol ditampilkan di notifikasi sistem pada iOS dan Android, baik aplikasi sedang terbuka, berjalan di latar belakang, maupun ditutup. Tombol juga tersedia di dalam pesannya sendiri. Bagian kedua ini penting: jika banner digeser hilang, tombolnya tetap ada saat Anda membuka pesan itu nanti.

- **Label** ditampilkan persis seperti yang Anda kirim di kedua platform. Jika iOS tidak sempat menyiapkan tombol kustom, iOS akan memakai label umum per jenis — **Open**, **Run**, **Copy** — dan tombolnya tetap berfungsi.
- **Layar kunci.** `http` dan `copy` berjalan dari layar kunci tanpa perlu membuka kunci. `view` membuka aplikasi atau browser, sehingga HP meminta Anda membuka kunci terlebih dahulu. Di Android, tombol hanya tampil di layar kunci jika layar kunci diatur untuk menampilkan isi notifikasi.
- **Permintaan gagal.** Jika permintaan `http` gagal (status selain 2xx/3xx atau error jaringan), muncul notifikasi dengan tombol **Retry**. Permintaan yang mungkin sudah sampai ke server Anda tidak pernah dicoba ulang secara otomatis.
- **Versi aplikasi.** Tombol notifikasi sistem memerlukan aplikasi Pocket Alert 2.0.1 atau yang lebih baru. Versi yang lebih lama hanya menampilkan tombol di dalam pesan.

## Alur persetujuan

Dua tombol `http` — **Approve** dan **Decline** — mengubah notifikasi menjadi panel kendali satu ketukan. Pola ini cocok untuk apa pun yang menunggu keputusan manusia:

- Pipeline deploy yang berhenti menunggu persetujuan manual
- Agen LLM yang perlu persetujuan sebelum mengeluarkan biaya atau menyentuh produksi
- Refund di atas batas tertentu
- Pintu, gerbang, lampu, garasi

Permintaan dikirim langsung dari HP ke endpoint Anda. Pocket Alert tidak meneruskan permintaan tersebut dan tidak melihat isi respons-nya.

> **Warning: Idempotency menjadi tanggung jawab Anda**
>
> Mengetuk tombol `http` yang sama dua kali akan mengirim permintaan dua kali — kami tidak memblokir pengulangan. Jika pengiriman ganda itu mahal, buat endpoint-nya idempotent.

## Tombol dari webhook

Webhook dapat membawa template aksi dengan placeholder `%path%`, yang diisi dari payload yang masuk. Peringatan Sentry bisa datang dengan tombol **Open issue** yang langsung menuju issue tersebut; event Stripe bisa datang dengan tombol **View payment** untuk tagihan itu.

Nilai yang disubstitusi di-escape sebagai JSON sebelum template di-parse, sehingga field payload yang berisi tanda kutip tidak bisa keluar dan menulis ulang URL. Jika sebuah tombol menghasilkan nilai yang tidak valid, misalnya tombol **Runbook** saat peringatan tidak memiliki URL runbook, hanya tombol itu yang dibuang; tombol lain dan pesannya tetap terkirim. Tombol yang rusak tidak akan pernah membuat Anda kehilangan peringatan.

Anda dapat mengatur template di konsol saat membuat atau mengedit webhook, atau melalui [API webhook](https://info.pocketalert.app/api/webhooks/create.md#action-buttons-template).

## Batas dan validasi

- Maksimal **3** tombol per pesan; tombol ditampilkan sesuai urutan pengiriman.
- Array `actions` boleh berukuran maksimal **2048 byte** setelah di-encode JSON. Array ini ikut dalam push, yang dibatasi 4 KB, sehingga `message` yang panjang akan dipersingkat untuk memberi ruang.
- `view` dan `http` memerlukan URL `http(s)` yang valid. Selain itu API mengembalikan `400`; dalam template webhook, tombol yang tidak valid akan dibuang.
- Nilai `type` yang tidak dikenal mengembalikan `400`.

> **Warning: Fitur berbayar**
>
> Tombol aksi dihapus dari pesan pada paket gratis, di sisi server. Pesannya sendiri tetap terkirim seperti biasa.

## Terkait

- [Create Message](https://info.pocketalert.app/api/messages/create.md) — array `actions` dan referensi permintaan lengkap
- [Tingkat prioritas](https://info.pocketalert.app/features/priority-levels.md) — seberapa keras peringatan itu terdengar
- [Pengaturan Webhook](https://info.pocketalert.app/api/webhooks/settings.md) — template aksi pada webhook masuk
