@capgo/capacitor-notifications

Konfigurasi debug

@capgo/capacitor-notifications menghubungkan sebuah Capacitor aplikasi ke Capgo’s pipeline notifikasi asli. Aplikasi Anda mendaftarkan ID pengguna pelanggan yang ditandatangani dengan Capgo, Capgo menyimpan status perangkat aktif terbaru di Cloudflare Engine Analitik, dan Anda dapat mengirim notifikasi, mengatur badge, memeriksa statistik pengiriman, dan mengaktifkan periksa update Capgo live secara diam-diam dari Capgo dashboard atau API.

Fitur ini dirancang untuk menghindari tabel perangkat notifikasi dengan kardinalitas tinggi di Capgo Postgres. Postgres hanya menyimpan data kontrol plane dengan kardinalitas rendah seperti pengaturan aplikasi, metadata kredential platform, draft kampanye, jadwal, dan catatan kampanye agregat. Status perangkat aktif dan event notifikasi adalah baris append-only Engine Analitik.

Apa yang disimpan oleh Capgo

Data	Dimana ia tinggal	Mengapa
Metadata kredential platform	Capgo Postgres	Diperlukan untuk mengelola pengaturan aplikasi dan izin.
Rahasia platform pribadi	Lingkungan pekerja	Hindari menyimpan kreditensi pribadi di tabel yang menghadap pelanggan.
Membuat kampanye dan pengaturan	Capgo Postgres	Data kontrol penerbangan dengan kardinalitas rendah.
Status pendaftaran perangkat aktif	Cloudflare Mesin Analitik	Daftar perangkat aktif yang murah dan dapat ditambahkan secara berurutan.
Event pemberitahuan	Cloudflare Mesin Analitik	Statistik murah untuk event yang antri, dikirim, diterima, dibuka, gagal, dan latar belakang.

Model Identitas

Capgo tidak meminta Anda untuk mengunggah daftar pengguna atau menjaga tabel perangkat.

• Pihak backend Anda tahu ID pengguna pelanggan yang sebenarnya.
• Pihak backend meminta Capgo untuk token yang berlaku singkat identityProof.
• Applikasi mendaftarkan diri dengan externalId dan bukti tersebut setelah autentikasi pengguna Anda sendiri berhasil.
• Capgo menghasilkan kunci internal yang deterministik untuk penerima dan instalasi native.
• Mengirim ke perangkat yang sama externalId menemukan perangkat aktif pengguna lagi.

Ini memungkinkan Anda mencari perangkat pengguna, menetapkan badge, dan mengarahkan kampanye notifikasi tanpa menyimpan baris notifikasi per-device di Capgo Postgres.

Kemampuan Utama

• Mendaftarkan perangkat dengan ID pengguna eksternal yang terautentikasi.
• Segarkan tag, atribut, persetujuan, dan status token pada saat aplikasi dijalankan atau perubahan token.
• Menerima notifikasi di latar depan dalam JavaScript.
• Melacak event notifikasi yang diterima dan dibuka.
• Menangani notifikasi data di latar belakang.
• Mengatur, menghapus, dan meningkatkan badge aplikasi.
• Membuat saluran notifikasi Android.
• Mengirim notifikasi satu kali, kampanye notifikasi, pembaruan badge, dan periksa update diam.
• Mengaktifkan @capgo/capacitor-updater dari notifikasi diam.

Statistik

Capgo menulis event notifikasi ke Cloudflare Engine Analitik sehingga statistik dashboard tetap murah:

• queued
• sent
• provider_accepted
• received
• opened
• failed
• permission_changed
• background_started
• background_finished

Statistik adalah signal operasional, bukan catatan permanen per-penerima. Retensi Mesin Analitik berarti perangkat aktif harus memperbarui registrasi secara berkala.

Publik API

Methode	Deskripsi
configure	Mengatur Capgo ID aplikasi, API host, dan perilaku integrasi pembaruan.
register	Mendaftarkan instalasi saat ini untuk ID pengguna pelanggan eksternal.
setExternalId	Mengubah ID pengguna pelanggan eksternal setelah login atau perubahan akun.
setTags	Mengganti tag yang digunakan untuk target audiens.
setBadge	Mengatur badge aplikasi asli.
clearBadge	Mengosongkan badge aplikasi asli.
incrementBadge	Mengincrement badge aplikasi asli.
enableUpdaterIntegration	Mengaktifkan penanganan pembaruan dalam mode diam melalui @capgo/capacitor-updater.
runUpdateCheck	Menggunakan integrasi pembaruan secara manual untuk tes.
trackReceived	Menulis event yang diterima secara manual.
trackOpened	Menulis event yang dibuka secara manual.
addListener('notificationReceived')	Dipicu ketika pemberitahuan diterima ketika JavaScript aktif.
addListener('notificationOpened')	Dipicu ketika pengguna membuka pemberitahuan.
addListener('backgroundNotification')	Dipicu untuk pemberitahuan data latar belakang dan mengungkapkan finish().
addListener('registrationChanged')	Dipicu ketika token push native berubah.

Jaminan Pengiriman

Push native setidaknya sekali. Kampanye dapat dicoba ulang, dan perangkat dapat menerima duplikat jika platform menerima pesan yang diulang. Gunakan ID penggabungan untuk pengecekan pembaruan dan buat pekerjaan latar belakang idempoten.

Pemberitahuan latar belakang iOS adalah usaha terbaik. Sistem operasi dapat mengurangi atau melewatkan eksekusi latar belakang berdasarkan baterai, perilaku pengguna, keadaan force-quit, dan kebijakan sistem. Jangan bergantung pada pemberitahuan diam untuk jadwal keras.

Teruskan dari @capgo/capacitor-notifikasi

Jika Anda menggunakan @capgo/capacitor-notifikasi untuk merencanakan pesan push, hubungkannya dengan Panduan Pemula untuk pengaturan awal, Pengembangan untuk troubleshooting, @capgo/capacitor-pengatur untuk periksa update diam, dan Capgo Direktori Plugin {"targetLanguage":"Indonesian","pagePath":"/id/docs/plugins/notifications/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"untuk plugin asli lainnya."},{"text":"Edit halaman"}]}