# Push notification Uptime Kuma di ponsel Anda: nyaring saat down, senyap saat kembali

> Kirim alert down dan up dari Uptime Kuma ke iPhone dan Android dengan notifikasi Webhook bawaan. Gangguan masuk sebagai prioritas tinggi, pemulihan masuk dengan senyap, kedaluwarsa sertifikat mendapat push tersendiri, dan retry mencegah check yang naik-turun membanjiri ponsel Anda.

*26.10.2026*

<!-- source: https://pocketalert.app/id/blog/uptime-kuma-notifications -->

Uptime Kuma bagus dalam mendeteksi bahwa sesuatu sedang down. Yang menjadi soal adalah ke mana pemberitahuan itu berakhir. Kebanyakan pengaturan mengirimkannya ke grup Telegram, kanal Discord, atau folder email, bersama semua hal lain yang membuat ponsel bergetar sepanjang hari. Dan pesan "back up" menimbulkan bunyi yang sama dengan pesan "down", sehingga setelah beberapa malam dengan status yang naik-turun, orang-orang membisukan kanal itu dan berhenti membacanya.

Panduan ini mengirim alert Uptime Kuma ke Pocket Alert sebagai push notification dengan prioritas yang berbeda. Monitor yang down masuk sebagai `high`, yang tetap lolos dari Fokus di iPhone. Pemulihan masuk sebagai `low`: pesan itu ada di feed saat Anda membukanya, dan tidak membangunkan siapa pun. Semuanya memakai tipe notifikasi **Webhook** bawaan Uptime Kuma, jadi tidak ada yang perlu dipasang tambahan.

Semua yang ada di bawah ini telah diuji pada Uptime Kuma 2.5.8 yang berjalan di Docker.

## Yang Anda butuhkan

- Uptime Kuma 2.x. Sebagian besar langkah ini juga berfungsi di 1.23.x; perbedaannya dicatat di bagian akhir.
- [Aplikasi](/get-app) Pocket Alert di ponsel Anda dan sebuah akun. [Daftar](/signup) jika Anda belum punya; paket gratis sudah cukup untuk memulai.
- Kunci API dari [API Keys](/account/apikeys) (rute 1) atau webhook dari [Webhooks](/webhooks) (rute 2).

## Dua cara menghubungkannya

Notifikasi Webhook Uptime Kuma dapat mengirim ke URL mana pun, dengan JSON bawaannya sendiri atau body yang Anda tulis. Itu memberi dua rute:

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th></th><th>Rute 1: API Pocket Alert</th><th>Rute 2: URL webhook Pocket Alert</th></tr></thead>
<tbody>
<tr><th>URL pengiriman</th><td><code>https://api.pocketalert.app/v1/messages</code></td><td><code>https://p4a.me/wh/&lt;slug&gt;</code></td></tr>
<tr><th>Judul push</th><td>Sesuai keinginan Anda, mis. <strong>Down: Website</strong></td><td>Selalu <strong>Webhook &lt;nama&gt;</strong></td></tr>
<tr><th>Down nyaring, Up senyap</th><td>Ya</td><td>Ya, dengan body kustom; jika tidak, satu level untuk semuanya</td></tr>
<tr><th>Rahasia disimpan di Uptime Kuma</th><td>Kunci API dengan akses penuh ke akun Anda</td><td>URL yang hanya bisa membuat push melalui webhook tersebut</td></tr>
<tr><th>Log permintaan di Pocket Alert</th><td>Tidak</td><td>Ya, di <a href="/id/features/webhook-history">riwayat webhook</a></td></tr>
</tbody>
</table>
</div>

**Pilih rute 1** jika Anda menginginkan judul yang mudah dibaca dan bagian yang bergerak paling sedikit. **Pilih rute 2** jika Anda lebih suka tidak menyimpan kunci API lengkap di Uptime Kuma (ia menyimpan pengaturan notifikasi, termasuk header, sebagai JSON biasa di database-nya), atau jika Anda ingin setiap permintaan yang dikirimnya tercatat di sisi Pocket Alert untuk debugging.

## Rute 1: kirim langsung ke API Pocket Alert

Di Uptime Kuma, buka **Settings → Notifications** lalu klik **Set Up Notification**. Isi seperti ini:

- **Notification Type:** Webhook
- **Friendly Name:** `Pocket Alert`
- **Post URL:** `https://api.pocketalert.app/v1/messages`
- **HTTP Method:** POST
- **Request Body:** Custom Body

Tempelkan ini ke kolom body, dengan mengganti `kuma.example.com` dengan alamat Uptime Kuma Anda:

```
{%- assign level = "default" -%}
{%- assign title = "Uptime Kuma" -%}
{%- assign text = msg -%}
{%- if heartbeatJSON -%}
  {%- assign text = heartbeatJSON.msg | default: msg -%}
  {%- if heartbeatJSON.status == 0 -%}
    {%- assign title = "Down: " | append: monitorJSON.name -%}
    {%- assign level = "high" -%}
    {%- for tag in monitorJSON.tags -%}
      {%- if tag.name == "critical" -%}{%- assign level = "critical" -%}{%- endif -%}
    {%- endfor -%}
  {%- else -%}
    {%- assign title = "Up: " | append: monitorJSON.name -%}
    {%- assign level = "low" -%}
  {%- endif -%}
{%- elsif msg contains "will expire" -%}
  {%- assign title = "Expiring soon" -%}
{%- endif -%}
{
  "title": {{ title | json }},
  "message": {{ text | json }},
  "level": "{{ level }}",
  "actions": [
    {
      "type": "view",
      "label": "Open in Uptime Kuma",
      "value": "https://kuma.example.com/dashboard/{{ monitorJSON.id }}"
    }
  ]
}
```

Lalu aktifkan **Additional Headers** dan tempelkan:

```json
{
  "Token": "YOUR_API_KEY",
  "Content-Type": "application/json"
}
```

Yang dilakukan body ini:

- **Body adalah template Liquid.** Uptime Kuma memberinya `msg` (teks siap pakai), `monitorJSON` (monitor) dan `heartbeatJSON` (check yang berubah statusnya). `heartbeatJSON.status` bernilai `0` untuk down dan `1` untuk up.
- **`| json` menulis string JSON yang utuh, termasuk tanda kutipnya.** Pesan error dan nama monitor bisa berisi tanda kutip dan backslash; dengan filter ini, keduanya tidak akan merusak permintaan. Monitor bernama `Bob's "main" site` tetap menghasilkan JSON yang valid.
- **Down adalah `high`, Up adalah `low`.** `high` bersifat mendesak di iPhone dan lolos dari Fokus serta ringkasan terjadwal. `low` dikirim tanpa menginterupsi Anda.
- **Beri tag `critical` pada monitor agar lebih nyaring.** Tambahkan tag bernama `critical` di Uptime Kuma pada monitor yang paling penting, dan gangguannya dikirim sebagai `critical`, yang tetap berbunyi meski sakelar senyap aktif dan saat Jangan Ganggu. Alert kritis adalah fitur berbayar; di paket gratis, alert ini dikirim sebagai `high`.
- **Pesan sertifikat dan pesan uji tidak memiliki heartbeat.** Untuk itu, push memakai teks bawaan Uptime Kuma sebagai pesan. Teks yang sama juga menjadi cadangan saat pesan heartbeat kosong, misalnya pada monitor ping yang kembali up; API menolak push dengan pesan kosong.
- **Tombolnya membuka monitor.** `/dashboard/<id>` adalah halaman monitor di Uptime Kuma. Untuk peringatan sertifikat tidak ada ID monitor, sehingga tombolnya membuka dasbor. Tombol aksi adalah fitur berbayar; di paket gratis, API membuangnya dan push dikirim tanpa tombol. Lihat [tombol aksi](/features/action-buttons) untuk kemampuan lainnya.

**Jangan lewatkan header `Content-Type`.** Saat Uptime Kuma mengirim body kustom, ia memberi label `application/x-www-form-urlencoded` kecuali Anda menyatakan sebaliknya. Itulah yang dikirimnya dalam uji saya. API Pocket Alert hanya menerima JSON atau multipart, dan akan membalas permintaan itu dengan `400`.

Klik **Test**. Push berjudul "Uptime Kuma" dengan teks "Pocket Alert Testing" seharusnya muncul dalam beberapa detik. Simpan.

Berikut yang dikirim Uptime Kuma 2.5.8 saat gangguan dan pemulihan sungguhan terjadi:

```json
{
  "title": "Down: Website",
  "message": "timeout of 4000ms exceeded",
  "level": "high",
  "actions": [
    { "type": "view", "label": "Open in Uptime Kuma", "value": "https://kuma.example.com/dashboard/1" }
  ]
}
```

```json
{
  "title": "Up: Website",
  "message": "200 - OK",
  "level": "low",
  "actions": [
    { "type": "view", "label": "Open in Uptime Kuma", "value": "https://kuma.example.com/dashboard/1" }
  ]
}
```

Gunakan kunci API terpisah yang dinamai sesuai Uptime Kuma, agar Anda bisa mencabutnya sendiri jika server tersebut suatu saat disusupi.

## Rute 2: URL webhook Pocket Alert

Di sini Uptime Kuma mengirim JSON-nya sendiri ke webhook Pocket Alert, dan sebuah template di sisi Pocket Alert mengubahnya menjadi push.

### Buat webhook

Template tombol hanya bisa diatur lewat API, jadi cara tercepat adalah satu perintah. Perintah ini membuat webhook bernama "Uptime Kuma" dengan template pesan, level default `high` (`1`), dan tombol "Open in Uptime Kuma", lalu mencetak URL penerimaannya:

```bash
PA_KEY='your-api-key'
KUMA_URL='https://kuma.example.com'

jq -n --arg kuma "$KUMA_URL" '{
  name: "Uptime Kuma",
  message: "%msg%",
  default_level: 1,
  actions: ([{type: "view", label: "Open in Uptime Kuma", value: ($kuma + "/dashboard/%monitor.id%")}] | tojson)
}' |
curl -sS https://api.pocketalert.app/v1/webhooks \
  -H "Token: $PA_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @- |
jq -r '"Receive URL: https://p4a.me/wh/" + .url'
```

Jika Anda lebih suka klik, buatlah di konsol pada [Webhooks](/webhooks): nama **Uptime Kuma**, **Default priority** High, pesan `%msg%`. Anda akan mendapat push yang sama tanpa tombol.

### Arahkan Uptime Kuma ke sana

Buat notifikasi baru bertipe **Webhook**, tempelkan URL penerimaan sebagai **Post URL**, dan atur **Request Body** ke **Preset - application/json**. Tidak perlu header: URL itu sendiri adalah rahasianya, jadi perlakukan seperti kata sandi. Jangan pilih preset multipart; webhook Pocket Alert hanya membaca JSON.

Uptime Kuma mengirim ini dari pengaturan uji saya saat sebuah monitor down (dipangkas; objek `monitor` memiliki sekitar seratus field):

```json
{
  "heartbeat": {
    "monitorID": 1,
    "status": 0,
    "time": "2026-10-31 16:09:56.331",
    "msg": "timeout of 4000ms exceeded",
    "important": true,
    "localDateTime": "2026-10-31 16:09:56"
  },
  "monitor": {
    "id": 1,
    "name": "Website",
    "url": "http://tls-target/",
    "type": "http",
    "tags": []
  },
  "msg": "[Website] [🔴 Down] timeout of 4000ms exceeded"
}
```

Template `%msg%` memakai `msg` tingkat atas, karena itu adalah satu-satunya field yang ada di setiap permintaan. Untuk peringatan sertifikat dan pesan uji, `heartbeat` dan `monitor` bernilai `null` dan hanya `msg` yang terisi. Push tiba dengan judul "Webhook Uptime Kuma" dan teks "[Website] [🔴 Down] timeout of 4000ms exceeded". Placeholder yang path-nya tidak ada akan dirender sebagai string kosong, jadi pada peringatan sertifikat tombolnya menunjuk ke `/dashboard/` dan tetap berfungsi.

### Down nyaring, Up senyap di rute ini

Dengan preset JSON, setiap permintaan mendapat level default webhook, sehingga pemulihan terdengar sama nyaringnya dengan gangguan. Untuk memperbaikinya, ubah **Request Body** ke **Custom Body** dan kirim field `level` sendiri. Webhook Pocket Alert membaca `level` tingkat atas dari payload sebelum kembali ke default:

```
{
  "level": "{% if heartbeatJSON %}{% if heartbeatJSON.status == 0 %}high{% else %}low{% endif %}{% else %}default{% endif %}",
  "msg": {{ msg | json }},
  "monitor": { "id": "{{ monitorJSON.id }}" }
}
```

Body ini mempertahankan nama field `msg` dan `monitor.id`, sehingga template pesan dan tombol webhook tetap berfungsi tanpa perubahan. Webhook Pocket Alert membaca body sebagai JSON apa pun `Content-Type`-nya, jadi rute ini tidak memerlukan header tambahan.

## Aktifkan untuk setiap monitor

Notifikasi tidak berpengaruh apa-apa sampai sebuah monitor memakainya. Di bagian bawah formulir notifikasi ada dua sakelar:

- **Default enabled** mencentang notifikasi ini pada setiap monitor yang Anda buat mulai sekarang.
- **Apply on all existing monitors** menambahkannya ke semua monitor yang sudah ada. Ini dijalankan sekali saat Anda menyimpan dan tidak diingat.

Aktifkan keduanya saat pertama kali menyimpan. Untuk mengecualikan sebuah monitor, buka monitor itu dan hilangkan centang notifikasi di formulir edit-nya.

## Peringatan kedaluwarsa sertifikat

Uptime Kuma dapat memperingatkan Anda sebelum sertifikat TLS habis masa berlakunya. Buka monitor HTTP(s) (monitor Keyword dan JSON Query juga memilikinya) lalu centang **Certificate Expiry Notification** di bawah **Advanced**. Kotak ini abu-abu saat **Ignore TLS/SSL errors for HTTPS websites** aktif.

Ambang batasnya bersifat global, di bawah **Settings → Notifications → TLS Certificate Expiry**, dan secara default 7, 14, dan 21 hari. Peringatan dikirim ke notifikasi yang sama dengan gangguan monitor, dengan teks seperti:

```text
[TLS site][https://tls-target/] server certificate tls-target will expire in 4 days
```

Body rute 1 menangkapnya dengan `msg contains "will expire"` dan memberinya judul "Expiring soon" pada level `default`. Uptime Kuma mengirimkannya sekali per ambang, bukan pada setiap check: dalam uji saya, monitor diperiksa 119 kali dengan sertifikat yang tinggal empat hari, dan tepat satu peringatan terkirim.

## Cegah monitor yang naik-turun membanjiri ponsel Anda

Tiga pengaturan monitor menentukan seberapa berisik layanan yang tidak stabil:

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th>Pengaturan</th><th>Fungsinya</th><th>Saran</th></tr></thead>
<tbody>
<tr><th>Retries</th><td>Check yang gagal ditandai <strong>Pending</strong> sebelum monitor dihitung sebagai down. Check pending tidak memberi notifikasi.</td><td><code>2</code> atau <code>3</code></td></tr>
<tr><th>Heartbeat Retry Interval</th><td>Jeda dalam detik antar-check saat pending.</td><td><code>20</code> sampai <code>60</code></td></tr>
<tr><th>Resend Notification if Down X times consecutively</th><td>Mengulangi alert down setelah sejumlah check gagal berikutnya. <code>0</code> mengirimnya sekali.</td><td><code>0</code>, atau nilai yang setara dengan 30 sampai 60 menit</td></tr>
</tbody>
</table>
</div>

Dengan **Retries** diatur ke 2 dalam uji saya, dua check gagal pertama ditandai pending dan hanya check ketiga yang mengirim "Down". Dengan **Resend** diatur ke 3, alert down diulang setelah setiap tiga check gagal berikutnya sampai layanan kembali. Jumlah resend dihitung dalam check, bukan menit. Dengan interval 60 detik, angka 30 berarti pengingat setiap setengah jam.

Setiap down, setiap up, dan setiap resend adalah satu pesan. Paket gratis mengizinkan 50 pesan per hari, sehingga satu monitor yang naik-turun tanpa retry bisa menghabiskannya dalam satu sore. Retry adalah solusi termurah.

## Jika tidak ada yang masuk

- **Test gagal dengan HTTP 400.** Di rute 1, pastikan **Additional Headers** berisi `"Content-Type": "application/json"`. Tanpa itu, permintaan dikirim sebagai data formulir.
- **HTTP 401.** Header `Token` hilang atau kuncinya sudah dicabut. Buat yang baru di [API Keys](/account/apikeys).
- **Test masuk tetapi gangguan tidak.** Buka monitor dan pastikan notifikasinya dicentang. Selain itu, Uptime Kuma tidak memberi notifikasi pada check pertama monitor jika statusnya up, jadi monitor baru akan diam sampai ada perubahan.
- **Rute 2 tidak menampilkan apa-apa.** Buka riwayat webhook di konsol. Jika permintaannya ada dengan error, di situ tertulis alasannya: JSON tidak valid, atau template yang menghasilkan pesan kosong. Jika sama sekali tidak ada catatan, berarti Uptime Kuma tidak pernah mencapai `p4a.me`. Anda juga bisa mengirim permintaan ke [webhook tester](/tools/webhook) untuk melihat persis apa yang dikirim Uptime Kuma.
- **Pemulihan sepertinya hilang.** Push `low` bersifat senyap. Periksa feed di aplikasi.

## FAQ

### Versi Uptime Kuma mana yang dibutuhkan?

Ini diuji pada 2.5.8, rilis terbaru saat tulisan ini dibuat. Versi 1.23.x juga memiliki tipe Webhook dengan Custom Body dan Additional Headers, dan template-nya mendapat variabel `msg`, `monitorJSON`, dan `heartbeatJSON` yang sama. Saya merender body rute 1 dengan mesin template yang dikirim bersama 1.23.16 dan mendapatkan JSON yang sama, tetapi uji end-to-end penuh hanya dilakukan pada 2.5.8.

### Bagaimana jika server yang menjalankan Uptime Kuma mati?

Maka tidak ada yang mengirim alert. Uptime Kuma tidak bisa melaporkan gangguannya sendiri, jadi jalankan sesuatu di luarnya yang mendeteksi, seperti check dari mesin lain atau monitor yang di-host. Halaman [pemantauan uptime](/use-cases/uptime-monitoring) mencantumkan monitor hosted yang bekerja dengan webhook Pocket Alert.

### Bisakah saya mengirim monitor yang berbeda ke ponsel yang berbeda?

Bisa, dengan paket berbayar. Buat satu notifikasi per grup dengan `device_id` yang berbeda di body (rute 1) atau webhook berbeda dengan perangkatnya sendiri (rute 2), lalu centang yang tepat pada setiap monitor. Paket gratis hanya punya satu perangkat dan satu webhook, jadi hanya ada satu ponsel tujuan.

### Apakah ini berfungsi untuk monitor ping, port, dan DNS?

Ya. Body hanya memakai nama dan ID monitor serta status dan pesan heartbeat, yang dimiliki setiap tipe monitor. Beberapa tipe, termasuk ping, membiarkan pesan kosong saat check berhasil; body kemudian memakai teks bawaan Uptime Kuma sebagai cadangan. Tombolnya menautkan ke halaman monitor di Uptime Kuma, bukan alamat yang diperiksa, sehingga tetap berfungsi meski alamat itu bukan URL.

### Saya sudah memakai ini untuk Proxmox. Bisakah berbagi kunci API?

Bisa, tetapi beri Uptime Kuma kuncinya sendiri agar mencabut yang satu tidak merusak yang lain. [Panduan Proxmox](/blog/proxmox-alerts) membahas alert backup dan disk dari homelab yang sama.

[Buat akun gratis](/signup), tempelkan body ke notifikasi Webhook, dan biarkan gangguan berikutnya sampai ke ponsel Anda sementara pemulihan menunggu dengan tenang di feed.
