@capgo/capacitor-notifications

Konfigurasi debug

@capgo/capacitor-notifications menghubungkan sebuah aplikasi Capacitor ke Capgo’s pipeline notifikasi native. Aplikasi Anda mendaftarkan ID pengguna pelanggan yang ditandatangani dengan Capgo, Capgo menyimpan status perangkat aktif terbaru di Cloudflare Engine Analitik, dan Anda dapat mengirimkan 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 Engine Analitik yang hanya dapat ditambahkan.

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	Environment pekerja	Avoidan menyimpan kreditensi pribadi di tabel yang menghadap pelanggan.
Rancangan dan pengaturan kampanye	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.
• Aplikasi mendaftarkan diri dengan externalId dan bukti tersebut setelah autentikasi pengguna sendiri berhasil.
• Capgo menghasilkan kunci internal yang deterministik untuk penerima dan instalasi native.
• Mengirim ke perangkat yang sama externalId mencari 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 Dasar

• Mendaftarkan perangkat dengan ID pengguna eksternal yang terautentikasi.
• Segarkan tag, atribut, persetujuan, dan status token pada saat aplikasi dimulai atau perubahan token.
• Menerima notifikasi di latar depan dengan 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, notifikasi kampanye, pembaruan badge, dan pengecekan 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.

Publik API

Metode	Deskripsi
configure	Mengatur ID aplikasi Capgo , host API , 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 ikon aplikasi asli.
clearBadge	Menghapus ikon aplikasi asli.
incrementBadge	Mengatur ikon aplikasi asli dengan nilai yang bertambah.
enableUpdaterIntegration	Memungkinkan penanganan pembaruan-silent secara otomatis. @capgo/capacitor-updater.
runUpdateCheck	Jalankan integrasi pembaruan secara manual untuk tes.
trackReceived	Menulis event yang diterima secara manual.
trackOpened	Menulis event yang dibuka secara manual.
addListener('notificationReceived')	Firing ketika penerimaan notifikasi sedang aktif.
addListener('notificationOpened')	Firing ketika pengguna membuka notifikasi.
addListener('backgroundNotification')	Firing untuk notifikasi data latar belakang dan mengungkapkan finish().
addListener('registrationChanged')	Firing ketika token push native berubah.

Jaminan Pengiriman

Pengiriman push native setidaknya sekali. Suatu kampanye dapat diulang, dan perangkat dapat menerima duplikat jika platform menerima pesan yang diulang. Gunakan ID penggabungan untuk pengecekan pembaruan dan buat pekerjaan latar idempoten.

Notifikasi 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 notifikasi-silent untuk jadwal keras.

Teruskan dari @capgo/capacitor-pemberitahuan

Jika Anda menggunakan @capgo/capacitor-pemberitahuan untuk merencanakan pesan push, hubungkannya dengan Panduan Pemula untuk pengaturan, Pengembangan untuk troubleshooting, @capgo/capacitor-pengatur untuk periksa update diam, dan Capgo Direktori Plugin {"targetLanguage":"Indonesia","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"}]}