Cara kerja push notification: penjelasan APNs dan 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
- Server Anda, yang oleh Apple disebut provider. Server memutuskan bahwa sesuatu harus dikirim.
- Layanan push, APNs atau FCM. Layanan ini menerima permintaan dan mengarahkannya.
- Perangkat. Sistem operasi mempertahankan satu koneksi terenkripsi berumur panjang ke Apple atau Google, dan menerima push untuk setiap aplikasi lewat koneksi itu.
- 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
.p8di 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 mendapat403 ExpiredProviderToken; jika memperbarui terlalu sering, Anda akan mendapat429 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:
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-topicadalah bundle ID aplikasi Anda.apns-push-typemenyatakan jenis push ini:alertuntuk notifikasi yang terlihat,backgrounduntuk push data senyap, dan beberapa jenis lain.apns-prioritybernilai10untuk dikirim sekarang,5untuk membiarkan kondisi daya perangkat menentukan, atau1untuk mengutamakan hemat daya dan tidak membangunkan perangkat.apns-expirationmenentukan berapa lama APNs terus mencoba.0berarti satu kali percobaan tanpa penyimpanan.apns-collapse-idmemungkinkan 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:
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:
passivehanya menambahkannya ke daftar tanpa menyalakan layar atau memutar suara.activeadalah nilai default.time-sensitivedapat menembus Fokus dan ringkasan notifikasi. Pengguna bisa mematikannya per aplikasi.criticalselalu 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 Unregistereduntuk 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 PayloadTooLargesaat 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:
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:
silentadalah notifikasi pasif tanpa suara di iPhone, dan masuk ke channel senyap di Android.lowadalah pasif di iPhone dan tingkat kepentingan rendah di Android.defaultadalah notifikasi normal di kedua platform.highadalah time-sensitive di iPhone dan prioritas tinggi di Android.criticalmenembus 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, dan tentang API itu sendiri di apa itu 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 untuk melewati kunci dan token, atau lihat perbandingan layanan lain di alternatif.