Langsung ke konten

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 ​

JenisFungsi tombolIsi value
viewMembuka URLURL-nya, misalnya https://status.example.com
httpMengirim permintaan HTTP di latar belakangString JSON: {"url":"…","method":"POST","headers":{…},"body":"…"}
copyMenyalin teks ke clipboardTeks 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.

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.

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.

Fitur berbayar

Tombol aksi dihapus dari pesan pada paket gratis, di sisi server. Pesannya sendiri tetap terkirim seperti biasa.

Terkait ​

Dokumentasi Pocket Alert