# Cara kerja push notification: penjelasan APNs dan FCM

> Setiap push ke iPhone melewati APNs milik Apple, dan hampir setiap push ke Android melewati FCM milik Google. Device token, autentikasi provider, isi permintaan, apa yang terjadi saat ponsel offline, dan cara kerja prioritas di tiap platform.

*05.10.2026*

<!-- source: https://pocketalert.app/id/blog/how-push-notifications-work-apns-fcm -->

Dari luar, push notification terlihat sederhana: sesuatu terjadi di server, lalu sedetik kemudian ponsel menyala. Di antara keduanya ada dua jaringan pengiriman yang dijalankan Apple dan Google, dan tidak ada notifikasi yang sampai ke ponsel tanpa melewati salah satunya.

- **APNs**, Apple Push Notification service, mengirim setiap push ke iPhone, iPad, Mac, dan Apple Watch.
- **FCM**, Firebase Cloud Messaging, mengirim ke perangkat Android yang memakai layanan Google Play, dan juga bisa mengirim ke iOS dengan meneruskan pesan ke APNs.

Panduan ini mengikuti satu notifikasi dari server Anda sampai ke layar kunci di kedua platform, beserta detail yang baru terlihat saat dijalankan di produksi. Kami menjalankan kedua alur ini di balik [Pocket Alert](/), jadi contohnya berasal dari yang benar-benar kami kirimkan.

## Empat pihak yang terlibat

1. **Server Anda**, yang oleh Apple disebut provider. Server memutuskan bahwa sesuatu harus dikirim.
2. **Layanan push**, APNs atau FCM. Layanan ini menerima permintaan dan mengarahkannya.
3. **Perangkat.** Sistem operasi mempertahankan satu koneksi terenkripsi berumur panjang ke Apple atau Google, dan menerima push untuk setiap aplikasi lewat koneksi itu.
4. **Aplikasi.** Aplikasi mendaftar untuk notifikasi dan memiliki token yang menjadi tujuan push.

Poin ketiga menjelaskan mengapa push hemat baterai. Ponsel tidak pernah melakukan polling ke server Anda. Satu koneksi, dipakai bersama oleh semua aplikasi, tetap terbuka, dan layanan push mengirim lewat koneksi itu saat ada yang perlu dikirim.

## Langkah 1: perangkat mendapatkan token

Saat aplikasi mendaftar untuk remote notification, OS memberinya token: alamat buram untuk "aplikasi ini di perangkat ini". Aplikasi mengirim token ke server Anda, dan server menyimpannya.

- **Device token APNs** bersifat unik untuk aplikasi dan perangkat. Apple menyarankan agar token tidak di-cache di aplikasi: token berubah saat pengguna memulihkan dari cadangan, pindah ke perangkat baru, atau memasang ulang OS.
- **Registration token FCM** punya peran yang sama di Android, dan FCM memperbaruinya sesuai jadwalnya sendiri.

Token sering kedaluwarsa. Menjaga token yang tersimpan tetap mutakhir adalah bagian besar dari menjalankan push.

## Langkah 2: server Anda membuktikan identitasnya

### APNs

APNs menggunakan HTTP/2 di atas TLS 1.2 atau lebih baru, di `api.push.apple.com` untuk produksi dan `api.sandbox.push.apple.com` untuk build development, pada port 443 atau 2197. Ada dua cara autentikasi:

- **Berbasis token.** Anda membuat kunci penandatanganan `.p8` di akun developer Apple lalu menandatangani JWT singkat dengan ES256, yang memuat Team ID dan ID kunci Anda. Apple meminta JWT ini diperbarui minimal 20 menit sekali dan maksimal 60 menit sekali. Jika mengirim JWT yang lebih lama, Anda akan mendapat `403 ExpiredProviderToken`; jika memperbarui terlalu sering, Anda akan mendapat `429 TooManyProviderTokenUpdates`.
- **Berbasis sertifikat.** Satu sertifikat klien TLS per aplikasi, berlaku selama setahun, lalu harus diperpanjang.

Gunakan autentikasi berbasis token. Satu kunci berlaku untuk semua aplikasi Anda dan tidak kedaluwarsa setiap tahun.

### FCM

HTTP v1 API FCM menerima access token OAuth 2.0 berumur pendek dari service account Google, dengan scope `firebase.messaging`. API "legacy" lama yang memakai server key statis sudah dideprecated pada 2023 dan dimatikan mulai Juli 2024, jadi kode yang masih mengirim `Authorization: key=...` tidak lagi berfungsi.

## Langkah 3: permintaannya

### Mengirim ke APNs

Setiap push adalah HTTP/2 POST ke `/3/device/<device token>`, dengan beberapa header yang mengubah cara penanganannya:

```bash
curl --http2 \
  -H "authorization: bearer $APNS_JWT" \
  -H "apns-topic: com.example.alerts" \
  -H "apns-push-type: alert" \
  -H "apns-priority: 10" \
  -d '{"aps": {"alert": {"title": "Backup failed", "body": "db-01: pg_dump exited with code 1"}, "sound": "default", "interruption-level": "time-sensitive"}}' \
  "https://api.push.apple.com/3/device/$DEVICE_TOKEN"
```

- `apns-topic` adalah bundle ID aplikasi Anda.
- `apns-push-type` menyatakan jenis push ini: `alert` untuk notifikasi yang terlihat, `background` untuk push data senyap, dan beberapa jenis lain.
- `apns-priority` bernilai `10` untuk dikirim sekarang, `5` untuk membiarkan kondisi daya perangkat menentukan, atau `1` untuk mengutamakan hemat daya dan tidak membangunkan perangkat.
- `apns-expiration` menentukan berapa lama APNs terus mencoba. `0` berarti satu kali percobaan tanpa penyimpanan.
- `apns-collapse-id` memungkinkan notifikasi yang lebih baru menggantikan notifikasi lama dengan id yang sama.

Payload berupa JSON dengan dictionary `aps`, dan batasnya **4 KB** (5 KB untuk VoIP).

### Mengirim ke FCM

FCM menerima satu pesan JSON per permintaan:

```bash
curl -X POST "https://fcm.googleapis.com/v1/projects/$PROJECT_ID/messages:send" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "message": {
      "token": "DEVICE_REGISTRATION_TOKEN",
      "notification": { "title": "Backup failed", "body": "db-01: pg_dump exited with code 1" },
      "android": { "priority": "high", "notification": { "channel_id": "alerts_high" } }
    }
  }'
```

Pesan `notification` ditampilkan oleh sistem saat aplikasi berada di latar belakang. Pesan `data` diserahkan ke aplikasi untuk diproses. Dalam kedua kasus, batas payload adalah **4.096 byte**.

## Langkah 4: pengiriman, atau menunggunya

Jika ponsel online, push dikirim lewat koneksi yang terbuka dan muncul dalam hitungan detik. Jika tidak:

- **APNs** menyimpan notifikasi hingga 30 hari, tergantung `apns-expiration`, tetapi hanya menyimpan **satu notifikasi per aplikasi per perangkat**. Jika Anda mengirim lima saat ponsel dalam mode pesawat, biasanya yang diterima hanya yang terakhir. Apple bahkan tidak menjamin itu benar-benar yang terbaru.
- **FCM** menyimpan pesan sesuai time to live-nya, empat minggu secara default dan paling lama 28 hari. Pesan yang bisa digabung saling menggantikan, dengan maksimal empat collapse key per perangkat.

Prioritas juga memengaruhi waktu pengiriman. Di iOS, push dengan prioritas `5` dan `1` bisa dikelompokkan, dibatasi laju, atau dibuang. Di Android, pesan prioritas `normal` mungkin menunggu sampai perangkat keluar dari Doze, sedangkan prioritas `high` dikirim segera. FCM juga memantau cara Anda memakai hak istimewa ini: pesan prioritas tinggi yang tidak menghasilkan notifikasi terlihat bisa diturunkan diam-diam menjadi normal seiring waktu.

## Seberapa keras bunyinya: interruption level dan channel

Pengiriman adalah satu hal. Apakah ponsel berbunyi adalah hal lain, dan kedua platform menanganinya dengan cara berbeda.

**iOS** (15 ke atas) memberi setiap notifikasi sebuah interruption level:

- `passive` hanya menambahkannya ke daftar tanpa menyalakan layar atau memutar suara.
- `active` adalah nilai default.
- `time-sensitive` dapat menembus Fokus dan ringkasan notifikasi. Pengguna bisa mematikannya per aplikasi.
- `critical` selalu berbunyi, bahkan saat Jangan Ganggu dan sakelar senyap aktif. Ini memerlukan entitlement yang diberikan Apple atas permintaan, setelah peninjauan.

**Android** (8 ke atas) menempatkan setiap notifikasi dalam sebuah **channel**, dan channel itulah yang menentukan tingkat kepentingannya: suara, getaran, heads-up display, perilaku Jangan Ganggu. Aplikasi membuat channel, tetapi setelah channel ada, perilakunya menjadi milik pengguna. Aplikasi tidak bisa mengubahnya kemudian.

Aturan terakhir itu punya konsekuensi nyata. Saat kami membuat peringatan kritis Pocket Alert berbunyi meski mode senyap aktif, channel kritis yang sudah ada tidak bisa dialihkan ke audio alarm setelah dibuat. Solusinya adalah channel kedua dengan id baru, dan server hanya memilihnya untuk build aplikasi yang membuatnya, karena mengirim ke channel yang tidak pernah dibuat aplikasi berarti notifikasinya tidak ditampilkan sama sekali.

Di Android 13 ke atas ada satu gerbang lagi: aplikasi memerlukan izin runtime `POST_NOTIFICATIONS`, dan pada pemasangan baru notifikasi tetap mati sampai pengguna memberikan izin tersebut.

## Apa yang rusak di produksi

- **Token kedaluwarsa.** APNs membalas `410 Unregistered` untuk token yang sudah tidak valid. Berhenti mengirim ke token itu dan hapus.
- **Lingkungan salah.** Token dari build development yang dikirim ke host produksi gagal dengan `400 BadDeviceToken`.
- **Payload terlalu besar.** `413 PayloadTooLarge` saat melebihi 4 KB. Baris log panjang di isi peringatan biasanya penyebabnya.
- **Prioritas diturunkan.** Pesan Android prioritas tinggi yang tidak pernah menampilkan apa pun kehilangan prioritasnya.
- **Notifikasi dimatikan.** Push terkirim tetapi pengguna tidak pernah melihatnya, karena izinnya ditolak atau channel-nya dibisukan.

## Jalan pintas

Semua ini layak dibangun jika aplikasi adalah produk Anda dan Anda mengirim ke penggunanya. Untuk peringatan ke diri sendiri atau tim, ini terlalu banyak infrastruktur: akun developer di tiap platform, kunci penandatanganan, penyimpanan token, dua format permintaan, dan dua model prioritas.

Layanan push notification menjalankan kedua alur itu untuk Anda. Dengan Pocket Alert, Anda cukup mengirim satu permintaan, tanpa token atau sertifikat sendiri:

```bash
curl -X POST https://api.pocketalert.app/v1/messages \
  -H "Token: $PA_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"title": "Backup failed", "message": "db-01: pg_dump exited with code 1", "level": "high"}'
```

Field `level` diterjemahkan untuk tiap platform:

- `silent` adalah notifikasi pasif tanpa suara di iPhone, dan masuk ke channel senyap di Android.
- `low` adalah pasif di iPhone dan tingkat kepentingan rendah di Android.
- `default` adalah notifikasi normal di kedua platform.
- `high` adalah time-sensitive di iPhone dan prioritas tinggi di Android.
- `critical` menembus Jangan Ganggu di Android. Di iPhone, notifikasinya tiba sebagai time-sensitive, dan suara critical alert penuh sedang diluncurkan seiring Apple memberikan entitlement-nya.

Informasi lebih lanjut ada di [critical alerts](/use-cases/critical-alerts), dan tentang API itu sendiri di [apa itu push notification API](/blog/what-is-a-push-notification-api).

## FAQ

### Apakah APNs menjamin pengiriman?

Tidak. APNs dan FCM sama-sama bersifat best-effort. APNs hanya menyimpan notifikasi terbaru untuk perangkat yang offline, dan tidak ada layanan yang menjamin kapan pesan tiba. Dokumentasi Google bahkan menyatakan FCM tidak boleh dipakai untuk peringatan darurat yang menyangkut keselamatan jiwa. Untuk paging on-call, perlakukan push sebagai saluran tercepat, bukan satu-satunya.

### Mengapa saya perlu APNs dan FCM sekaligus?

iPhone hanya menerima push lewat APNs. Perangkat Android dengan layanan Google Play menerimanya lewat FCM. Jika pengguna Anda ada di kedua platform, server Anda berkomunikasi dengan keduanya, secara langsung atau lewat FCM, yang bisa meneruskan ke APNs untuk Anda.

### Bisakah FCM mengirim notifikasi ke iPhone?

Bisa. Anda mengunggah kunci autentikasi APNs ke Firebase, dan FCM mengirim ke iOS dengan meneruskan pesan ke APNs. Pesan data ke perangkat Apple harus dikirim dengan prioritas normal.

### Seberapa besar push notification boleh berukuran?

4 KB untuk payload APNs (5 KB untuk push VoIP), dan 4.096 byte untuk pesan FCM. Teks panjang sebaiknya ada di aplikasi Anda atau di tautan, bukan di push.

### Apa itu device token?

Alamat untuk satu aplikasi di satu perangkat, diterbitkan oleh Apple atau Google. Server Anda mengirim push ke alamat ini. Token bisa berubah kapan saja, jadi server harus menerima token yang diperbarui dan membuang token yang dilaporkan tidak valid oleh APNs atau FCM.

[Daftar akun Pocket Alert gratis](/signup) untuk melewati kunci dan token, atau lihat perbandingan layanan lain di [alternatif](/alternatives).
